std::vprint_unicode(std::ostream)

 

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)

 

std::basic_ostream

Globale Objekte
coutwcout	cerrwcerr	clogwclog
Memberfunktionen
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
Formatierte Ausgabe
basic_ostream::operator<<
Unformatierte Ausgabe
basic_ostream::put
basic_ostream::write
Positionierung
basic_ostream::tellp
basic_ostream::seekp
Sonstiges
basic_ostream::flush
basic_ostream::swap (C++11)
Member-Klassen
basic_ostream::sentry
Nicht-Member-Funktionen
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

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 Formatierungszeichenkette fmt und schreibt das Ergebnis in den Ausgabestrom os. Verhält sich als 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, als ob durch std::string out = std::vformat(os.getloc(), fmt, args);.
3. Schreibt out nach os.

• Wenn os auf ein Terminal verweist, das nur über eine native Unicode-API Unicode anzeigen kann, wird os geleert und out mit der nativen Unicode-API an das Terminal geschrieben.
• Andernfalls wird die Zeichensequenz [out.begin(), out.end()) in os eingefügt.

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

Nachdem Zeichen in os geschrieben wurden, wird ein beobachtbarer Prüfpunkt (observable checkpoint) eingerichtet.

(seit C++26)

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

Parameter

os	-	Ausgabestream, in den Daten eingefügt werden sollen
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.
• Leitet jede Ausnahme, die von einem beliebigen Formatter ausgelöst wird, z. B. std::format_error, ohne Berücksichtigung des Werts von os.exceptions() und ohne ios_base::badbit im Fehlerzustand von os zu aktivieren, weiter.
• Kann ios_base::failure auslösen, die durch os.setstate(ios_base::badbit) verursacht wird, was aufgerufen wird, wenn ein Einfügen in os fehlschlägt.

Hinweise

Wenn das Aufrufen der nativen Unicode-API eine Transkodierung erfordert, werden die ungültigen Code Units durch U+FFFD REPLACEMENT CHARACTER ersetzt (siehe "The Unicode Standard - Core Specification", Kapitel 3.9).

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_print	202207L	(C++23)	Formatierte Ausgabe
__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
LWG 4044	C++23	die native Unicode-API wurde immer verwendet, wenn das Terminal, auf das sich os bezieht, Unicode anzeigen kann	nur verwendet, wenn das Terminal nur verwenden kann die native Unicode-API, um Unicode anzuzeigen

Siehe auch

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

Externe Links

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