std::wprintf, std::fwprintf, std::swprintf

 

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)

 

C-Style I/O

Typen und Objekte
FILE fpos_t	stdinstdoutstderr
Funktionen
Datei-Zugriff fopen freopen fclose fflush fwide setbuf setvbuf Direkte Ein-/Ausgabe fread fwrite Unformatierte Ein-/Ausgabe fgetcgetc fgets fputcputc fputs getchar gets (bis C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc Formatierte Eingabe scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	Formatierte Ausgabe printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove rename tmpfile tmpnam

 

Definiert in Header <cwchar>
int wprintf( const wchar_t* format, ... );	(1)
int fwprintf( std::FILE* stream, const wchar_t* format, ... );	(2)
int swprintf( wchar_t* buffer, std::size_t size, const wchar_t* format, ... );	(3)

Lädt die Daten von den angegebenen Speicherorten, konvertiert sie in breite Zeichenkettenäquivalente und schreibt die Ergebnisse in verschiedene Ausgabeziele.

1) Schreibt die Ergebnisse nach stdout.

2) Schreibt die Ergebnisse in einen Dateistrom stream.

3) Schreibt die Ergebnisse in eine breite Zeichenkette buffer. Maximal size - 1 breite Zeichen werden gefolgt von einem Null-Breitzeichen geschrieben.

Parameter

stream	-	Ausgabestream, in den geschrieben werden soll
buffer	-	Zeiger auf eine breite Zeichenkette, in die geschrieben werden soll
size	-	Bis zu size - 1 Zeichen dürfen geschrieben werden, plus der Nullterminator
format	-	Zeiger auf eine nullterminierte Wide-Zeichenkette, die angibt, wie die Daten zu interpretieren sind
...	-	Argumente, die die zu druckenden Daten angeben. Wenn ein Argument nach den Standardkonvertierungen nicht den vom entsprechenden Konvertierungsspezifizierer erwarteten Typ hat oder wenn weniger Argumente vorhanden sind, als von format benötigt werden, ist das Verhalten undefiniert. Wenn mehr Argumente vorhanden sind, als von format benötigt werden, werden die überschüssigen Argumente ausgewertet und ignoriert.

Die format-Zeichenkette besteht aus normalen Wide-Zeichen (außer %), die unverändert in den Ausgabestrom kopiert werden, und Konvertierungsspezifikationen. Jede Konvertierungsspezifikation hat das folgende Format:

• ein einführendes %-Zeichen.

• (optional) ein oder mehrere Flags, die das Verhalten der Konversion modifizieren

• -: Das Ergebnis der Konversion wird im Feld linksbündig ausgerichtet (standardmäßig rechtsbündig).
• +: Das Vorzeichen von Vorzeichenkonversionen wird immer dem Ergebnis der Konversion vorangestellt (standardmäßig wird dem Ergebnis nur dann ein Minus vorangestellt, wenn es negativ ist).
• Leerzeichen: Wenn das Ergebnis einer Vorzeichenkonversion nicht mit einem Vorzeichen beginnt oder leer ist, wird dem Ergebnis ein Leerzeichen vorangestellt. Es wird ignoriert, wenn das Flag + vorhanden ist.
• #: Eine alternative Form der Konversion wird durchgeführt. Die genauen Effekte sind in der untenstehenden Tabelle aufgeführt, andernfalls ist das Verhalten undefiniert.
• 0: Bei Ganzzahl- und Gleitkommazahlenkonversionen werden die Felder mit Nullen aufgefüllt anstelle von Leerzeichen. Bei Ganzzahlen wird dies ignoriert, wenn die Genauigkeit explizit angegeben ist. Bei anderen Konversionen führt die Verwendung dieses Flags zu undefiniertem Verhalten. Es wird ignoriert, wenn das Flag - vorhanden ist.

• (optional) ein Ganzzahlwert oder *, der die minimale Feldbreite angibt. Das Ergebnis wird, falls erforderlich, mit Leerzeichen aufgefüllt (standardmäßig) links, wenn rechtsbündig, oder rechts, wenn linksbündig. Wenn * verwendet wird, wird die Breite durch ein zusätzliches Argument vom Typ int angegeben, das vor dem zu konvertierenden Argument und dem Präzisionsargument (falls vorhanden) steht. Wenn der Wert des Arguments negativ ist, resultiert dies in der Angabe des Flags - und einer positiven Feldbreite (Hinweis: Dies ist die minimale Breite: Der Wert wird niemals abgeschnitten).

• (optional) . gefolgt von einer Ganzzahl oder *, oder weder noch, das die Genauigkeit der Konversion angibt. Wenn * verwendet wird, wird die Genauigkeit durch ein zusätzliches Argument vom Typ int angegeben, das vor dem zu konvertierenden Argument steht, aber nach dem Argument für die minimale Feldbreite (falls vorhanden). Wenn der Wert dieses Arguments negativ ist, wird es ignoriert. Wenn weder eine Zahl noch * verwendet wird, wird die Genauigkeit als Null angenommen. Die genauen Effekte der Genauigkeit sind in der untenstehenden Tabelle aufgeführt.

• (optional) Ein Längenmodifikator, der die Größe des Arguments angibt (in Kombination mit dem Konversionsformat-Spezifizierer gibt er den Typ des entsprechenden Arguments an).

• Ein Konversionsformat-Spezifizierer.

Die folgenden Format-Spezifizierer sind verfügbar:

Konversion Spezifizierer	Erklärung	Erwartet Argumenttyp
Längenmodifikator →		hh	h	keine	l	ll	j	z	t	L
Nur verfügbar ab C++11 →		Ja				Ja	Ja	Ja	Ja
%	Schreibt ein literales %. Die vollständige Konversionsspezifikation muss %% sein.	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A
c	Schreibt ein einzelnes Zeichen. Das Argument wird zuerst nach wchar_t konvertiert, als ob durch Aufruf von std::btowc. Wenn der Modifikator l verwendet wird, wird das std::wint_t-Argument zuerst nach wchar_t konvertiert.	N/A	N/A	int	std::wint_t	N/A	N/A	N/A	N/A	N/A
s	Schreibt eine Zeichenkette. Das Argument muss ein Zeiger auf das erste Element eines Zeichenarrays sein, das eine Multibyte-Zeichensequenz enthält, die sich im initialen Verschiebezustand befindet und die als breite Zeichenkette konvertiert wird, als ob durch einen Aufruf von std::mbrtowc mit einem mit Null initialisierten Konvertierungszustand. Präzision gibt die maximale Anzahl von zu schreibenden Wide-Zeichen an. Wenn Präzision nicht angegeben ist, werden alle Wide-Zeichen bis zum ersten Nullterminator, diesen aber nicht einschließend, geschrieben. Wenn der l-Spezifizierer verwendet wird, muss das Argument ein Zeiger auf das erste Element eines Arrays von wchar_t sein.	N/A	N/A	char*	wchar_t*	N/A	N/A	N/A	N/A	N/A
d i	Konvertiert eine vorzeichenbehaftete Ganzzahl in die Dezimaldarstellung [-]dddd. Genauigkeit gibt die minimale Anzahl der anzuzeigenden Ziffern an. Die Standardgenauigkeit ist 1. Wenn sowohl der konvertierte Wert als auch die Genauigkeit ​0​ sind, erzeugt die Konversion keine Zeichen. Für den z-Modifikator ist der erwartete Argumenttyp die vorzeichenbehaftete Version von std::size_t.	signed char	short	int	long	long long	std::intmax_t	※	std::ptrdiff_t	N/A
o	Konvertiert eine vorzeichenlose Ganzzahl in die Oktaldarstellung oooo. Genauigkeit gibt die minimale Anzahl der anzuzeigenden Ziffern an. Die Standardgenauigkeit ist 1. Wenn sowohl der konvertierte Wert als auch die Genauigkeit ​0​ sind, erzeugt die Konversion keine Zeichen. In der alternativen Implementierung wird die Genauigkeit bei Bedarf erhöht, um eine führende Null zu schreiben. In diesem Fall wird, wenn sowohl der konvertierte Wert als auch die Genauigkeit ​0​ sind, eine einzelne ​0​ geschrieben.	unsigned char	unsigned short	unsigned int	unsigned long	unsigned long long	std::uintmax_t	std::size_t	vorzeichenlose Version von std::ptrdiff_t	N/A
x X	Konvertiert eine vorzeichenlose Ganzzahl in die Hexadezimaldarstellung hhhh. Für die x-Konversionsbuchstaben werden abcdef verwendet. Für die X-Konversionsbuchstaben werden ABCDEF verwendet. Genauigkeit gibt die minimale Anzahl der anzuzeigenden Ziffern an. Die Standardgenauigkeit ist 1. Wenn sowohl der konvertierte Wert als auch die Genauigkeit ​0​ sind, erzeugt die Konversion keine Zeichen. In der alternativen Implementierung wird den Ergebnissen 0x oder 0X vorangestellt, wenn der konvertierte Wert ungleich Null ist.									N/A
u	Konvertiert eine vorzeichenlose Ganzzahl in die Dezimaldarstellung dddd. Genauigkeit gibt die minimale Anzahl der anzuzeigenden Ziffern an. Die Standardgenauigkeit ist 1. Wenn sowohl der konvertierte Wert als auch die Genauigkeit ​0​ sind, erzeugt die Konversion keine Zeichen.									N/A
f F (C++11)	Konvertiert eine Gleitkommazahl in die Dezimalnotation im Stil [-]ddd.ddd. Genauigkeit gibt die genaue Anzahl der Ziffern nach dem Dezimaltrennzeichen an. Die Standardgenauigkeit ist 6. In der alternativen Implementierung wird das Dezimaltrennzeichen auch dann geschrieben, wenn keine Ziffern darauf folgen. Informationen zur Konversion von Unendlichkeit und Nicht-Zahl im Hinblick auf den Stil finden Sie unter Anmerkungen.	N/A	N/A	double	double (C++11)	N/A	N/A	N/A	N/A	long double
e E	Konvertiert eine Gleitkommazahl in die Dezimal-Exponent-Notation. Für den e-Konversionsstil wird [-]d.ddd e±dd verwendet. Für den E-Konversionsstil wird [-]d.ddd E±dd verwendet. Der Exponent enthält mindestens zwei Ziffern, mehr Ziffern werden nur bei Bedarf verwendet. Wenn der Wert ​0​ ist, ist auch der Exponent ​0​. Genauigkeit gibt die genaue Anzahl der Ziffern nach dem Dezimaltrennzeichen an. Die Standardgenauigkeit ist 6. In der alternativen Implementierung wird das Dezimaltrennzeichen auch dann geschrieben, wenn keine Ziffern darauf folgen. Informationen zur Konversion von Unendlichkeit und Nicht-Zahl im Hinblick auf den Stil finden Sie unter Anmerkungen.	N/A	N/A			N/A	N/A	N/A	N/A
a A (C++11)	Konvertiert eine Gleitkommazahl in die Hexadezimal-Exponent-Notation. Für den a-Konversionsstil wird [-] 0xh.hhh p±d verwendet. Für den A-Konversionsstil wird [-] 0Xh.hhh P±d verwendet. Die erste Hexadezimalziffer ist nicht 0, wenn das Argument ein normalisierter Gleitkommawert ist. Wenn der Wert ​0​ ist, ist auch der Exponent ​0​. Genauigkeit gibt die exakte Anzahl der Ziffern nach dem Hexadezimaltrennzeichen an. Die Standardgenauigkeit ist ausreichend für die exakte Darstellung des Wertes. In der alternativen Implementierung wird das Dezimaltrennzeichen auch dann geschrieben, wenn keine Ziffern darauf folgen. Informationen zur Konversion von Unendlichkeit und Nicht-Zahl im Hinblick auf den Stil finden Sie unter Anmerkungen.	N/A	N/A			N/A	N/A	N/A	N/A
g G	Konvertiert eine Gleitkommazahl je nach Wert und Genauigkeit in die Dezimal- oder Dezimal-Exponent-Notation. Für den g-Konversionsstil wird die Konversion mit dem Stil e oder f durchgeführt. Für den G-Konversionsstil wird die Konversion mit dem Stil E oder f(bis C++11)F(seit C++11) durchgeführt. Sei P gleich der Genauigkeit, wenn diese ungleich Null ist, 6, wenn die Genauigkeit nicht angegeben ist, oder 1, wenn die Genauigkeit ​0​ ist. Dann, wenn eine Konversion im Stil E einen Exponenten von X hätte: Wenn P > X ≥ −4, erfolgt die Konversion im Stil f oder F(seit C++11) mit einer Genauigkeit von P − 1 − X. Andernfalls erfolgt die Konversion im Stil e oder E mit einer Genauigkeit von P − 1. Sofern keine alternative Darstellung angefordert wird, werden nachfolgende Nullen entfernt, und das Dezimaltrennzeichen wird entfernt, wenn kein Bruchteil übrig bleibt. Informationen zur Konversion von Unendlichkeit und Nicht-Zahl im Hinblick auf den Stil finden Sie unter Anmerkungen.	N/A	N/A			N/A	N/A	N/A	N/A
n	Gibt die bisher von diesem Funktionsaufruf geschriebene Anzahl der Zeichen zurück. Das Ergebnis wird an den Wert geschrieben, auf den das Argument zeigt. Die Spezifikation darf keine Flags, Feldbreiten oder Genauigkeiten enthalten. Für den z-Modifikator ist der erwartete Argumenttyp S*, wobei S die vorzeichenbehaftete Version von std::size_t ist.	signed char*	short*	int*	long*	long long*	std::intmax_t*	※	std::ptrdiff_t*	N/A
p	Schreibt eine implementierungsdefinierte Zeichensequenz, die einen Zeiger darstellt.	N/A	N/A	void*	N/A	N/A	N/A	N/A	N/A	N/A
Anmerkungen
Die Gleitkommakonversionsfunktionen konvertieren Unendlichkeit in inf oder infinity. Welche Variante verwendet wird, ist implementierungsabhängig. Nicht-Zahlen werden in nan oder nan(char_sequence) konvertiert. Welche Variante verwendet wird, ist implementierungsabhängig. Die Konversionen F, E, G, A geben stattdessen INF, INFINITY, NAN aus. Der Konvertierungsspezifizierer, der zum Drucken von char, unsigned char, signed char, short und unsigned short verwendet wird, erwartet die geförderten Typen der Standardargumentförderungen, aber bevor sein Wert gedruckt wird, wird er in char, unsigned char, signed char, short und unsigned short konvertiert. Es ist sicher, Werte dieser Typen zu übergeben, da die Förderung stattfindet, wenn eine variadische Funktion aufgerufen wird. Die korrekten Konversionsspezifizierer für zeichenfeste Breiten-Typen (std::int8_t, etc.) sind im Header <cinttypes> definiert (obwohl PRIdMAX, PRIuMAX, etc. synonym mit %jd, %ju, etc. sind). Der speicherschreibende Konversionsspezifizierer %n ist ein häufiges Ziel von Sicherheitslücken, bei denen Formatzeichenketten von Benutzereingaben abhängen. Es gibt einen Sequenzpunkt nach der Ausführung jedes Konversionsspezifizierers; dies ermöglicht das Speichern mehrerer %n-Ergebnisse in derselben Variablen oder, als Randfall, das Drucken einer Zeichenkette, die durch ein früheres %n innerhalb desselben Aufrufs modifiziert wurde. Wenn eine Konversionsspezifikation ungültig ist, ist das Verhalten undefiniert.

Rückgabewert

1,2) Anzahl der geschriebenen Wide-Characters im Erfolgsfall oder ein negativer Wert, wenn ein Fehler aufgetreten ist.

3) Anzahl der geschriebenen breiten Zeichen (ohne das abschließende Null-Breitzeichen), wenn erfolgreich, oder ein negativer Wert, wenn ein Kodierungsfehler aufgetreten ist oder wenn die Anzahl der zu generierenden Zeichen gleich oder größer als size war (einschließlich des Falls, dass size Null ist).

Hinweise

Während schmale Zeichenketten std::snprintf bereitstellen, was es ermöglicht, die erforderliche Ausgabepuffergröße zu bestimmen, gibt es kein Äquivalent für breite Zeichenketten, und um die Puffergröße zu bestimmen, muss das Programm möglicherweise std::swprintf aufrufen, den Rückgabewert prüfen und einen größeren Puffer neu zuweisen, und es erneut versuchen, bis es erfolgreich ist.

Beispiel

Führen Sie diesen Code aus

#include <clocale>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    char narrow_str[] = "z\u00df\u6c34\U0001f34c";
                  // or "zß水🍌";
                  // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c";
    wchar_t warr[29]; // the expected string is 28 characters plus 1 null terminator
    std::setlocale(LC_ALL, "en_US.utf8");
 
    std::swprintf(warr, sizeof warr/sizeof *warr,
                  L"Converted from UTF-8: '%s'", narrow_str);
 
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << warr << '\n';
}

Ausgabe

Converted from UTF-8: 'zß水🍌'

Siehe auch

printffprintfsprintfsnprintf (C++11)	druckt formatierte Ausgabe nach stdout, einen Dateistream oder einen Puffer (Funktion)
vwprintfvfwprintfvswprintf	druckt formatierte breite Zeichen-Ausgabe nach stdout, einem Dateistream oder einem Puffer mit variabler Argumentenliste (Funktion)
fputws	schreibt einen Weitzeichenstring in einen Dateistream (Funktion)
C-Dokumentation für wprintf, fwprintf, swprintf