std::println

 

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)

 

Druckfunktionen

Druckfunktionen

print (C++23)

println (C++23)

vprint_unicodevprint_unicode_buffered (C++23)(C++23)

vprint_nonunicodevprint_nonunicode_buffered (C++23)(C++23)

 

Definiert in Header <print>
template< class... Args > void println( std::format_string<Args...> fmt, Args&&... args );	(1)	(seit C++23)
template< class... Args > void println( std::FILE* stream,               std::format_string<Args...> fmt, Args&&... args );	(2)	(seit C++23)
void println();	(3)	(seit C++26)
void println( std::FILE* stream );	(4)	(seit C++26)

Formatiert die Argumente args gemäß dem Format-String fmt mit angehängtem '\n' (was bedeutet, dass jede Ausgabe mit einer neuen Zeile endet) und gibt das Ergebnis in einen Stream aus.

1) Entspricht std::println(stdout, fmt, std::forward<Args>(args)...).

2) Entspricht der Ausführung der folgenden Operationen:

std::print(stream, "{}\n", std::format(fmt, std::forward<Args>(args)...));	(bis C++26)
std::print(stream, std::runtime_format(std::string(fmt.get()) + '\n'),            std::forward<Args>(args)...	(seit C++26)

3) Entspricht std::println(stdout).

4) Entspricht std::print(stream, "\n").

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

Parameter

stream	-	Ausgabestream, in den geschrieben werden soll
fmt	-	ein Objekt, das den Formatstring repräsentiert. Der Formatstring besteht aus regulären Zeichen (außer { und }), die unverändert in die Ausgabe kopiert werden, Escape-Sequenzen {{ und }}, die in der Ausgabe durch { und } ersetzt werden, und Ersetzungsfeldern. Jedes Ersetzungsfeld hat das folgende 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 werden soll; wenn er weggelassen wird, werden die Argumente in der Reihenfolge verwendet. Die `arg-id`s in einem Formatstring müssen entweder alle vorhanden sein oder alle weggelassen werden. Das Mischen von manueller und automatischer Indizierung ist ein Fehler. format-spec - die Formatangabe, die durch die std::formatter-Spezialisierung für das entsprechende Argument definiert ist. Kann nicht mit } beginnen. Für Basistypen und Standard-Stringtypen wird die Formatangabe als Standard-Formatangabe 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 Tupel-Formatangabe interpretiert. Für std::thread::id und std::stacktrace_entry siehe Thread-ID-Formatangabe und Stacktrace-Eintrags-Formatangabe. Für std::basic_stacktrace ist keine Formatierungsangabe erlaubt. (seit C++23) Für std::filesystem::path siehe Pfad-Formatangabe. (seit C++26) Für andere formatierbare Typen wird die Formatangabe durch benutzerspezifische formatter-Spezialisierungen bestimmt.
args...	-	zu formatierende Argumente

Ausnahmen

• std::bad_alloc bei Zuweisungsfehler.
• std::system_error, wenn das Schreiben in den Stream fehlschlägt.
• Propagiert jede Ausnahme, die von verwendeten Formatierern ausgelöst wird, z. B. std::format_error.

Hinweise

Obwohl die Überladungen (3,4) in C++26 hinzugefügt werden, stellen alle bekannten Implementierungen sie bereits im C++23-Modus zur Verfügung.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_print	202207L	(C++23)	Formatierte Ausgabe
	202403L	(C++26)	Ungepufferte formatierte Ausgabe
__cpp_lib_format	202207L	(C++23)	Freigabe von std::basic_format_string

Beispiel

Führen Sie diesen Code aus

#include <print>
 
int main()
{
    // Each call to std::println ends with new-line
    std::println("Please"); // overload (1)
    std::println("enter"); // (1)
 
    std::print("pass");
    std::print("word");
 
    std::println(); // (3); valid since C++26; same effect as std::print("\n"); 
}

Ausgabe

Please
enter
password
 

Siehe auch

print (C++23)	druckt nach stdout oder einem Dateistream unter Verwendung der formatierten Darstellung der Argumente (Funktionstemplate)
println(std::ostream) (C++23)	gibt die formatierten Darstellung der Argumente mit angehängtem '\n' aus (Funktions-Template)
format (C++20)	speichert die formatierte Darstellung der Argumente in einem neuen String (Funktionstemplate)
printffprintfsprintfsnprintf (C++11)	druckt formatierte Ausgabe nach stdout, einen Dateistream oder einen Puffer (Funktion)