std::left, std::right, std::internal

 

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 in Header <ios>
std::ios_base& left( std::ios_base& str );	(1)
std::ios_base& right( std::ios_base& str );	(2)
std::ios_base& internal( std::ios_base& str );	(3)

Ändert die Positionierung der Füllzeichen in einem Ausgabestrom. left und right gelten für jeden auszugebenden Typ, internal gilt für Ganzzahl-, Gleitkomma- und monetäre Ausgaben. Hat keine Auswirkungen auf die Eingabe.

1) Setzt das adjustfield des Streams str auf left, als ob str.setf(std::ios_base::left, std::ios_base::adjustfield) aufgerufen worden wäre.

2) Setzt das adjustfield des Streams str auf right, als ob str.setf(std::ios_base::right, std::ios_base::adjustfield) aufgerufen worden wäre.

3) Setzt das adjustfield des Streams str auf internal, als ob str.setf(std::ios_base::internal, std::ios_base::adjustfield) aufgerufen worden wäre.

Der anfängliche Standard für Standardströme ist äquivalent zu right.

Dies ist ein I/O-Manipulator. Er kann mit einem Ausdruck wie out << std::left für jedes out vom Typ std::basic_ostream oder mit einem Ausdruck wie in >> std::left für jedes in vom Typ std::basic_istream verwendet werden.

Parameter

str

-

Referenz auf einen E/A-Stream.

Rückgabewert

str (Referenz auf den Stream nach der Manipulation).

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <locale>
 
int main()
{
    std::cout.imbue(std::locale("en_US.utf8"));
 
    std::cout << "Default positioning:\n" << std::setfill('*')
              << std::setw(12) << -1.23  << '\n'
              << std::setw(12) << std::hex << std::showbase << 42 << '\n'
              << std::setw(12) << std::put_money(123, true) << "\n\n";
 
    std::cout << "Left positioning:\n" << std::left
              << std::setw(12) << -1.23  << '\n'
              << std::setw(12) << 42 << '\n'
              << std::setw(12) << std::put_money(123, true) << "\n\n";
 
    std::cout << "Internal positioning:\n" << std::internal
              << std::setw(12) << -1.23  << '\n'
              << std::setw(12) << 42 << '\n'
              << std::setw(12) << std::put_money(123, true) << "\n\n";
 
    std::cout << "Right positioning:\n" << std::right
              << std::setw(12) << -1.23  << '\n'
              << std::setw(12) << 42 << '\n'
              << std::setw(12) << std::put_money(123, true) << '\n';
}

Ausgabe

Default positioning:
*******-1.23
********0x2a
***USD *1.23
 
Left positioning:
-1.23*******
0x2a********
USD *1.23***
 
Internal positioning:
-*******1.23
0x********2a
USD ****1.23
 
Right positioning:
*******-1.23
********0x2a
***USD *1.23

Siehe auch

setw	Ändert die Breite des nächsten Eingabe-/Ausgabefeldes (Funktion)
setfill	Ändert das Füllzeichen (Funktion-Template)
showbasenoshowbase	Steuert, ob ein Präfix zur Anzeige der numerischen Basis verwendet wird (Funktion)