std:: vprint_unicode (std::ostream)

Definiert in Header <ostream>
void vprint_unicode ( std:: ostream & os, std:: string_view fmt, std:: format_args args ) ;		(seit C++23)

Formatiert args gemäß der Formatzeichenkette fmt und schreibt das Ergebnis in den Ausgabestrom os . Verhält sich wie eine FormattedOutputFunction von os , mit der Ausnahme, dass einige Details der Fehlerberichterstattung abweichen .

Führt die folgenden Operationen in der angegebenen Reihenfolge aus:

1. Zuerst konstruiert und prüft die Funktion das sentry -Objekt.
2. Initialisiert eine automatische Variable wie durch std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; .
3. Schreibt out nach os :

• Falls os auf ein Terminal verweist, das Unicode nur über eine native Unicode-API anzeigen kann, leert es os und schreibt out unter Verwendung der nativen Unicode-API auf das Terminal.
• Andernfalls fügt es die Zeichenfolge [ out. begin ( ) , out. end ( ) ) in os ein.

Wenn das Schreiben in das Terminal oder das Einfügen in os fehlschlägt, ruft es os. setstate ( std:: ios_base :: badbit ) auf.

Nachdem Zeichen in os geschrieben wurden, wird ein beobachtbarer Kontrollpunkt etabliert.

(since C++26)

Wenn out ungültige Unicode- Codeeinheiten enthält, wenn die native Unicode-API verwendet wird, ist das Verhalten undefiniert.

Inhaltsverzeichnis 1 Parameter 2 Ausnahmen 3 Hinweise 4 Beispiel 5 Fehlerberichte 6 Siehe auch 7 Externe Links

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-Zeichenkettentypen 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. (since C++23) Für std::filesystem::path siehe Pfadformatangabe . (since C++26) Für andere formatierbare Typen wird die Formatangabe durch benutzerdefinierte formatter -Spezialisierungen bestimmt.
args	-	zu formatierende Argumente

Ausnahmen

• 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

Wenn der Aufruf der nativen Unicode-API Transkodierung erfordert, werden ungültige Codeeinheiten durch den U+FFFD REPLACEMENT CHARACTER ersetzt (siehe "The Unicode Standard - Core Specification", Kapitel 3.9 ).

Feature-Test Makro	Wert	Std	Funktion
__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 4044	C++23	die native Unicode-API wurde immer verwendet, wenn das Terminal, auf das os verweist, Unicode anzeigen kann	nur verwendet, wenn das Terminal nur die native Unicode-API zur Unicode-Anzeige nutzen kann

Siehe auch

vprint_nonunicode (std::ostream) (C++23)	gibt Zeichendaten unter Verwendung typlöschter Argumentdarstellung aus (Funktion)
print (std::ostream) (C++23)	gibt formatierte Darstellung der Argumente aus (Funktionsschablone)
operator<< (std::basic_ostream)	fügt Zeichendaten ein oder fügt in Rvalue-Stream ein (Funktionsschablone)
vprint_unicode vprint_unicode_buffered (C++23)	druckt zu Unicode-fähigem stdout oder einem Dateistream unter Verwendung typlöschter Argumentdarstellung (Funktion)
format (C++20)	speichert formatierte Darstellung der Argumente in einem neuen String (Funktionsschablone)

Externe Links

1.	Unicode — Wikipedia
2.	The Unicode Standard Version 14.0 — Core Specification