std::vprint_nonunicode, std::vprint_nonunicode_buffered

 

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>
void vprint_nonunicode( std::FILE* stream,                         std::string_view fmt, std::format_args args );	(1)	(seit C++23)
void vprint_nonunicode_buffered     ( std::FILE* stream, std::string_view fmt, std::format_args args );	(2)	(seit C++23)
void vprint_nonunicode_buffered     ( std::string_view fmt, std::format_args args );	(3)	(seit C++23)

Formatiert args gemäß der Formatierungszeichenkette fmt und schreibt das Ergebnis in den Ausgabestrom.

1) Unter Sperre auf stream schreibt die Zeichenrepräsentation der Formatierungsargumente, bereitgestellt durch args, formatiert gemäß der Spezifikation in fmt, nach stream.

Wenn stream kein gültiger Zeiger auf einen C-Ausgabestrom ist, ist das Verhalten undefiniert.

2) Äquivalent zu std::string out = std::vformat(fmt, args);
std::vprint_nonunicode(stream, "{}", std::make_format_args(out));.

3) Äquivalent zu std::vprint_nonunicode_buffered(stdout, fmt, args).

Nach dem Schreiben von Zeichen in den Ausgabestrom wird ein beobachtbarer Kontrollpunkt etabliert.

(seit C++26)

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

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	Druckoperationen waren immer gepuffert	bieten unbuffered Druckoperationen
P3235R3	C++23	die Namen der hinzugefügten Funktionen von P3107R5 waren irreführend	die Funktionsnamen geändert wurden

Siehe auch

vprint_unicodevprint_unicode_buffered (C++23)	druckt auf Unicode-fähige stdout oder einen Dateistream unter Verwendung der typ-erased Argumentdarstellung (Funktion)
vprint_nonunicode(std::ostream) (C++23)	gibt Zeichendaten aus unter Verwendung einer typ-erased Argumentdarstellung (type-erased) (function)
print (C++23)	druckt nach stdout oder einem Dateistream unter Verwendung der formatierten Darstellung der Argumente (Funktionstemplate)
format (C++20)	speichert die formatierte Darstellung der Argumente in einem neuen String (Funktionstemplate)