std::setfill

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

Input/output-Manipulatoren

Formatierung von Gleitkommazahlen
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
Ganzzahlformatierung
setbase showbasenoshowbase	dechexoct
Boolean-Formatierung
boolalphanoboolalpha
Feldbreiten- und Füllzeichensteuerung
setfill setw	internalleftright
Andere Formatierungen
showposnoshowpos	uppercasenouppercase
Leerzeichenverarbeitung
ws ends	skipwsnoskipws
Ausgabe-Flushen
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
Statusflags-Manipulation
resetiosflags	setiosflags
Zeit- und Geld-I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
Gequoteter Manipulator
quoted (C++14)

 

Definiert im Header <iomanip>
template< class CharT > /*unspecified*/ setfill( CharT c );

Wenn es in einem Ausdruck verwendet wird out << setfill(c), wird das Füllzeichen des Streams out auf c gesetzt.

Parameter

c

-

neuer Wert für das Füllzeichen

Rückgabewert

Ein Objekt eines nicht spezifizierten Typs, so dass

• Wenn out ein Objekt vom Typ std::basic_ostream<CharT, Traits> ist, verhält sich der Ausdruck out << setfill(c)
  • vom Typ std::basic_ostream<CharT, Traits>& ist
  • hat den Wert out
  • so, als ob f(out, c) aufgerufen worden wäre

wobei die Funktion f definiert ist als

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, CharT c)
{
    // set fill character
    str.fill(c);
}

Hinweise

Das aktuelle Füllzeichen kann mit std::ostream::fill abgerufen werden.

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
 
int main()
{
    std::cout << "default fill: [" << std::setw(10) << 42 << "]\n"
              << "setfill('*'): [" << std::setfill('*')
                                   << std::setw(10) << 42 << "]\n";
}

Ausgabe

default fill: [        42]
setfill('*'): [********42]

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 183	C++98	setbase konnte nur mit Streams vom Typ std::ostream verwendet werden	mit jedem Ausgang verwendbar Zeichenstrom

Siehe auch

fill	verwaltet das Füllzeichen (public member function of std::basic_ios<CharT,Traits>)
internalleftright	Legt die Platzierung von Füllzeichen fest (Funktion)
setw	Ändert die Breite des nächsten Eingabe-/Ausgabefeldes (Funktion)