std::vprint_nonunicode(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_nonunicode( std::ostream& os,                         std::string_view fmt, std::format_args args );		(seit C++23)

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

Führt die folgenden Operationen in der angegebenen Reihenfolge aus

1. Zuerst wird ein 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.

Nach dem Schreiben von Zeichen in os wird ein beobachtbarer Prüfpunkt eingerichtet.

(seit C++26)

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

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

Siehe auch

vprint_unicode(std::ostream) (C++23)	führt Unicode-fähige Ausgabe unter Verwendung einer typ-erased Argumentdarstellung durch (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_nonunicodevprint_nonunicode_buffered (C++23)	druckt auf 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)