std::print

 

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 print( std::format_string<Args...> fmt, Args&&... args );	(1)	(seit C++23)
template< class... Args > void print( std::FILE* stream,             std::format_string<Args...> fmt, Args&&... args );	(2)	(seit C++23)

Formatiert args gemäß dem Formatstring fmt und druckt das Ergebnis in einen Ausgabestream.

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

2) Wenn die gewöhnliche Literalcodierung UTF-8 ist, entspricht dies (std::enable_nonlocking_formatter_optimization<std::remove_cvref_t<Args>> && ...)
    ? std::vprint_unicode(stream, fmt.str, std::make_format_args(args...))
    : std::vprint_unicode_buffered(stream, fmt.str, std::make_format_args(args...));.

Andernfalls entspricht dies (std::enable_nonlocking_formatter_optimization<std::remove_cvref_t<Args>> && ...)
    ? std::vprint_nonunicode(stream, fmt.str, std::make_format_args(args...))
    : std::vprint_nonunicode_buffered(stream, fmt.str, std::make_format_args(args...));.

Wenn std::formatter<Ti, char> die BasicFormatter-Anforderungen für ein beliebiges `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

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_print	202207L	(C++23)	Formatierte Ausgabe
	202403L	(C++26) (DR23)	Ungepufferte formatierte Ausgabe
	202406L	(C++26) (DR23)	Aktivierung ungepufferter formatierter Ausgabe für mehr formatierbare Typen
__cpp_lib_format	202207L	(C++23)	Freigabe von std::basic_format_string

Beispiel

Führen Sie diesen Code aus

#include <cstdio>
#include <filesystem>
#include <print>
 
int main()
{
    std::print("{2} {1}{0}!\n", 23, "C++", "Hello");  // overload (1)
 
    const auto tmp{std::filesystem::temp_directory_path() / "test.txt"};
    if (std::FILE* stream{std::fopen(tmp.c_str(), "w")})
    {
        std::print(stream, "File: {}", tmp.string()); // overload (2)
        std::fclose(stream);
    }
}

Ausgabe

Hello C++23!

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
P3107R5	C++23	nur gepufferte Druckoperationen können durchgeführt werden	kann ungepufferte Druckoperationen durchführen
P3235R3	C++23	die Namen der hinzugefügten Funktionen von P3107R5 waren irreführend	die Funktionsnamen geändert wurden

Siehe auch

println (C++23)	dasselbe wie std::print, außer dass jeder Druck durch eine zusätzliche neue Zeile beendet wird (Funktionstemplate)
print(std::ostream) (C++23)	gibt die formatierten Darstellung der Argumente aus (Funktionstemplate)
format (C++20)	speichert die formatierte Darstellung der Argumente in einem neuen String (Funktionstemplate)
format_to (C++20)	schreibt die formatierte Darstellung ihrer Argumente über einen Output-Iterator (Funktionstemplate)
printffprintfsprintfsnprintf (C++11)	druckt formatierte Ausgabe nach stdout, einen Dateistream oder einen Puffer (Funktion)