std:: vprint_nonunicode (std::ostream)

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

Verhält sich wie eine FormattedOutputFunction (außer dass einige Details der Fehlerberichterstattung abweichen ).

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

1. Zuerst wird das sentry -Objekt konstruiert und geprüft.
2. Dann wird eine automatische Variable initialisiert, als ob durch std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; .
3. Schließlich wird die Zeichensequenz [ out. begin ( ) , out. end ( ) ) in os eingefügt.

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

(since C++26)

Inhaltsverzeichnis 1 Parameter 2 Ausnahmen 3 Anmerkungen 4 Beispiel 5 Siehe auch

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 für die Formatierung verwendet wird; falls ausgelassen, werden die Argumente in Reihenfolge verwendet. Die arg-id s in einer Formatzeichenkette müssen entweder alle vorhanden oder alle ausgelassen sein. 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-Stringtypen 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. (seit C++23) Für std::filesystem::path siehe Pfadformatangabe . (seit C++26) Für andere formatierbare Typen wird die Formatangabe durch benutzerdefinierte formatter -Spezialisierungen bestimmt.
args	-	zu formatierende Argumente

Exceptions

• 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

Feature-Test Makro	Wert	Std	Feature
__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

Siehe auch

vprint_unicode (std::ostream) (C++23)	führt Unicode-fähige Ausgabe unter Verwendung von typeradierten Argumentdarstellungen durch (Funktion)
print (std::ostream) (C++23)	gibt formatierte Darstellungen der Argumente aus (Funktionsschablone)
operator<< (std::basic_ostream)	fügt Zeichendaten ein oder fügt in Rvalue-Stream ein (Funktionsschablone)
vprint_nonunicode vprint_nonunicode_buffered (C++23)	gibt auf stdout oder einen Dateistream unter Verwendung von typeradierten Argumentdarstellungen aus (Funktion)
format (C++20)	speichert formatierte Darstellungen der Argumente in einem neuen String (Funktionsschablone)