std::setw

 

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>
/* nicht spezifiziert */ setw( int n );

Wenn verwendet in einem Ausdruck wie out << std::setw(n) oder in >> std::setw(n), setzt den width Parameter des Streams out oder in auf exakt n.

Einige Operationen setzen die Breite auf Null zurück (siehe unten), daher muss std::setw möglicherweise wiederholt aufgerufen werden, um die Breite für mehrere Operationen einzustellen.

Parameter

n

-

neuer Wert für die Breite

Rückgabewert

Ein Objekt eines nicht spezifizierten Typs, so dass

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

wobei die Funktion f definiert ist als

void f(std::ios_base& str, int n)
{
    // set width
    str.width(n);
}

Hinweise

Die Breiten-Eigenschaft des Streams wird auf Null zurückgesetzt (was "nicht spezifiziert" bedeutet), wenn eine der folgenden Funktionen aufgerufen wird:

• Eingabe

• operator>>(basic_istream&, basic_string&)
• operator>>(basic_istream&, char*)

• Ausgabe

• Überladungen von basic_ostream::operator<<(), die arithmetische Typen oder void-Zeiger nehmen (in Phase 3 von num_put::put())
• operator<<(basic_ostream&, char) und operator<<(basic_ostream&, char*)
• operator<<(basic_ostream&, basic_string&)
• std::put_money (innerhalb von money_put::put())
• std::quoted (wenn mit einem Ausgabestream verwendet)

Die genauen Auswirkungen dieses Modifikators auf Ein- und Ausgabe variieren je nach den einzelnen I/O-Funktionen und werden auf den jeweiligen Seiten der operator<< und operator>> Überladungen individuell beschrieben.

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    std::cout << "no setw: [" << 42 << "]\n"
              << "setw(6): [" << std::setw(6) << 42 << "]\n"
              << "no setw, several elements: [" << 89 << 12 << 34 << "]\n"
              << "setw(6), several elements: [" << 89 << std::setw(6) << 12 << 34 << "]\n";
 
    std::istringstream is("hello, world");
    char arr[10];
 
    is >> std::setw(6) >> arr;
    std::cout << "Input from \"" << is.str() << "\" with setw(6) gave \""
              << arr << "\"\n";
}

Ausgabe

no setw: [42]
setw(6): [    42]
no setw, several elements: [891234]
setw(6), several elements: [89    1234]
Input from "hello, world" with setw(6) gave "hello"

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	setw konnte nur mit Streams von Typ std::ostream oder std::istream verwendet werden	verwendbar mit jedem Zeichenstrom

Siehe auch

width	verwaltet die Feldbreite (public member function of std::ios_base)
setfill	Ändert das Füllzeichen (Funktion-Template)
internalleftright	Legt die Platzierung von Füllzeichen fest (Funktion)
showbasenoshowbase	Steuert, ob ein Präfix zur Anzeige der numerischen Basis verwendet wird (Funktion)