std:: println (std::ostream)

Definiert im Header <ostream>
template < class ... Args > void println ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;	(1)	(seit C++23)
void println ( std:: ostream & os ) ;	(2)	(seit C++26)

Formatiert args gemäß der Formatzeichenkette fmt mit angehängtem ' \n ' (was bedeutet, dass jede Ausgabe mit einer neuen Zeile endet), und fügt das Ergebnis in den os Stream ein.

Das Verhalten ist undefiniert, falls std:: formatter < Ti, char > nicht die BasicFormatter -Anforderungen für irgendein Ti in Args erfüllt (wie von std:: make_format_args gefordert).

Inhaltsverzeichnis 1 Parameter 2 Ausnahmen 3 Anmerkungen 4 Beispiel 5 Fehlermeldungen 6 Siehe auch

Parameter

os	-	Ausgabestrom, in den Daten eingefügt werden
fmt	-	ein Objekt, das die Formatzeichenkette repräsentiert. Die Formatzeichenkette besteht aus gewöhnlichen Zeichen (außer { und } ), die unverändert in die Ausgabe kopiert werden, Escape-Sequenzen { { und } } , die in der Ausgabe durch { bzw. } ersetzt werden, und Ersetzungsfeldern. Jedes Ersetzungsfeld hat folgendes Format: { arg-id (optional) } (1) { arg-id (optional) : format-spec } (2) 1) Ersetzungsfeld ohne Formatangabe 2) Ersetzungsfeld mit Formatangabe arg-id - gibt den Index des Arguments in args an, dessen Wert zur Formatierung verwendet wird; falls ausgelassen, werden die Argumente in Reihenfolge verwendet. Die arg-id s in einer Formatzeichenkette müssen entweder alle angegeben oder alle ausgelassen werden. Das Vermischen von manueller und automatischer Indizierung ist ein Fehler. format-spec - die Formatangabe, definiert durch die std::formatter -Spezialisierung für das entsprechende Argument. Darf nicht mit } beginnen. Für Basistypen und Standard-Stringtypen wird die Formatangabe als Standardformatangabe interpretiert. Für Chrono-Typen wird die Formatangabe als Chrono-Formatangabe interpretiert. Für Bereichstypen wird die Formatangabe als Bereichsformatangabe interpretiert. Für std::pair und std::tuple wird die Formatangabe als Tupelformatangabe interpretiert. Für std::thread::id und std::stacktrace_entry siehe Thread-ID-Formatangabe und Stacktrace-Eintrag-Formatangabe . Für std::basic_stacktrace ist keine Formatangabe erlaubt. (seit C++23) Für std::filesystem::path siehe Pfadformatangabe . (seit C++26) Für andere formatierbare Typen wird die Formatangabe durch benutzerdefinierte formatter -Spezialisierungen bestimmt.
args...	-	zu formatierende Argumente

Exceptions

• std::bad_alloc bei Allokationsfehlern.
• Leitet jede Ausnahme weiter, die von einem formatter geworfen wird, z.B. std::format_error , unabhängig vom Wert von os. exceptions ( ) und ohne ios_base::badbit im Fehlerzustand von os zu aktivieren.
• Kann ios_base::failure werfen, verursacht durch os. setstate ( ios_base :: badbit ) , das aufgerufen wird, wenn eine Einfügung in os fehlschlägt.

Hinweise

Obwohl Überladung ( 2 ) in C++26 hinzugefügt wird, machen alle bekannten Implementierungen sie bereits im C++23-Modus verfügbar.

Feature-Test Makro	Wert	Std	Feature
__cpp_lib_print	202207L	(C++23)	Formatierte Ausgabe
__cpp_lib_format	202207L	(C++23)	Verfügbarmachen von std::basic_format_string

Beispiel

Dieser Abschnitt ist unvollständig Grund: Kein Beispiel

Fehlerberichte

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

DR	Angewendet auf	Verhalten wie veröffentlicht	Korrektes Verhalten
LWG 4088	C++23	( 1 ) ignorierte das in os eingebettete Locale bei der Formatierung der Argumente	solches Locale wird verwendet

Siehe auch

print (std::ostream) (C++23)	gibt formatierte Darstellung der Argumente aus (Funktions-Template)
println (C++23)	identisch mit std::print außer dass jede Ausgabe durch zusätzliche neue Zeile beendet wird (Funktions-Template)
format (C++20)	speichert formatierte Darstellung der Argumente in einem neuen String (Funktions-Template)