std::wscanf, std::fwscanf, std::swscanf

 

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 wscanf( const wchar_t* format, ... );	(1)
int fwscanf( std::FILE* stream, const wchar_t* format, ... );	(2)
int swscanf( const wchar_t* buffer, const wchar_t* format, ... );	(3)

Liest Daten aus einer Vielzahl von Quellen, interpretiert sie gemäß format und speichert die Ergebnisse an den angegebenen Speicherorten.

1) Liest die Daten von stdin.

2) Liest die Daten aus dem Dateistream stream.

3) Liest die Daten aus dem nullterminierten Wide-String buffer.

Parameter

stream	-	Eingabedateistream, aus dem gelesen werden soll.
buffer	-	Zeiger auf einen nullterminierten Wide-String, aus dem gelesen werden soll.
format	-	Zeiger auf einen nullterminierten Wide-String, der angibt, wie die Eingabe gelesen werden soll.
...	-	empfangende Argumente.

Der Formatstring besteht aus

• Nicht-Leerzeichen-Wide-Zeichen außer %: Jedes solche Zeichen in der Formatzeichenkette verbraucht genau ein identisches Zeichen aus dem Eingabestrom oder bewirkt, dass die Funktion fehlschlägt, wenn das nächste Zeichen im Strom nicht übereinstimmt.
• Leerzeichen: Jedes einzelne Leerzeichen in der Formatzeichenkette verbraucht alle aufeinanderfolgenden aufeinanderfolgenden Leerzeichen aus der Eingabe (bestimmt so, als ob std::iswspace in einer Schleife aufgerufen würde). Beachten Sie, dass es keinen Unterschied zwischen "\n", " ", "\t\t" oder anderen Leerzeichen in der Formatzeichenkette gibt.
• Konvertierungsspezifikationen. Jede Konvertierungsspezifikation hat das folgende Format:

• Einführendes %-Zeichen.

• (optional) Zuweisungsunterdrückendes Zeichen *. Wenn diese Option vorhanden ist, weist die Funktion das Ergebnis der Konvertierung keinem empfangenden Argument zu.

• (optional) Ganze Zahl (größer als Null), die die *maximale Feldbreite* angibt, d. h. die maximale Anzahl von Zeichen, die die Funktion bei der durch die aktuelle Konvertierungsspezifikation angegebenen Konvertierung verbrauchen darf. Beachten Sie, dass %s und %[ zu einem Pufferüberlauf führen können, wenn die Breite nicht angegeben ist.

• (optional) Längenmodifikator, der die Größe des Empfängerarguments angibt, d.h. den tatsächlichen Zieltyp. Dies wirkt sich auf die Genauigkeit der Konvertierung und die Überlaufregeln aus. Der Standard-Zieltyp ist für jeden Konvertierungstyp unterschiedlich (siehe Tabelle unten).

• 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
%	Entspricht dem literalen %.	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A
c	Entspricht einem Zeichen oder einer Sequenz von Zeichen. Wenn ein Breiten-Spezifizierer verwendet wird, werden genau Breite Wide-Zeichen abgeglichen (das Argument muss ein Zeiger auf ein Array mit ausreichend Platz sein). Im Gegensatz zu %s und %[ wird kein Nullzeichen an das Array angehängt.	N/A	N/A	char*	wchar_t*	N/A	N/A	N/A	N/A	N/A
s	Entspricht einer Sequenz von Nicht-Whitespace-Zeichen (einem String). Wenn ein Breiten-Spezifizierer verwendet wird, werden bis zu Breite oder bis zum ersten Whitespace-Zeichen abgeglichen, je nachdem, was zuerst eintritt. Speichert immer ein Nullzeichen zusätzlich zu den abgeglichenen Zeichen (daher muss das Argumentarray Platz für mindestens Breite+1 Zeichen haben).
[set ]	Entspricht einer nicht-leeren Sequenz von Zeichen aus set von Zeichen. Wenn das erste Zeichen des Sets ^ ist, werden alle Zeichen, die nicht im Set enthalten sind, abgeglichen. Wenn das Set mit ] oder ^] beginnt, wird das Zeichen ] ebenfalls in das Set aufgenommen. Es ist implementierungsabhängig, ob das Zeichen - in nicht-initialer Position im Scanset einen Bereich angibt, wie in [0-9]. Wenn ein Breiten-Spezifizierer verwendet wird, werden nur bis zu Breite abgeglichen. Speichert immer ein Nullzeichen zusätzlich zu den abgeglichenen Zeichen (daher muss das Argumentarray Platz für mindestens Breite+1 Zeichen haben).
d	Entspricht einer Dezimalganzzahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstol mit dem Wert 10 für das Argument base.	signed char* oder unsigned char*	signed short* oder unsigned short*	signed int* oder unsigned int*	signed long* oder unsigned long*	signed long long* oder unsigned long long*	std::intmax_t* oder std::uintmax_t*	std::size_t*	std::ptrdiff_t*	N/A
i	Entspricht einer Ganzzahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstol mit dem Wert ​0​ für das Argument base (die Basis wird durch die ersten geparsten Zeichen bestimmt).
u	Entspricht einer vorzeichenlosen Dezimalganzzahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstoul mit dem Wert 10 für das Argument base.
o	Entspricht einer vorzeichenlosen Oktalganzzahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstoul mit dem Wert 8 für das Argument base.
x X	Entspricht einer vorzeichenlosen Hexadezimalganzzahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstoul mit dem Wert 16 für das Argument base.
n	Gibt die bisher gelesene Anzahl von Zeichen zurück. Es werden keine Eingaben verbraucht. Erhöht die Zählung der Zuweisungen nicht. Wenn der Spezifizierer den Operator zur Unterdrückung von Zuweisungen aufweist, ist das Verhalten undefiniert.
a (C++11) A (C++11) e E f F (C++11) g G	Entspricht einer Gleitkommazahl. Das Zahlenformat ist dasselbe wie erwartet von std::wcstof.	N/A	N/A	float*	double*	N/A	N/A	N/A	N/A	long double*
p	Entspricht einer implementierungsdefinierten Zeichensequenz, die einen Zeiger definiert. Die `printf`-Funktionsfamilie sollte mit dem Format-Spezifizierer `%p` die gleiche Sequenz erzeugen.	N/A	N/A	void**	N/A	N/A	N/A	N/A	N/A	N/A
Anmerkungen
Für jeden Konvertierungsspezifizierer außer n gilt: Die längste Folge von Eingabezeichen, die keine angegebene Feldbreite überschreitet und entweder genau dem entspricht, was der Konvertierungsspezifizierer erwartet, oder ein Präfix einer Folge ist, die er erwarten würde, wird aus dem Strom verbraucht. Das erste Zeichen nach dieser verbrauchten Folge bleibt ungelesen. Wenn die verbrauchte Folge eine Länge von Null hat oder wenn die verbrauchte Folge nicht wie oben angegeben konvertiert werden kann, tritt ein Abgleichfehler auf, es sei denn, EOF, ein Kodierungsfehler oder ein Lesefehler hat die Eingabe aus dem Strom verhindert, in welchem Fall es sich um einen Eingabefehler handelt. Alle Konvertierungsspezifizierer außer [, c und n verbrauchen und verwerfen alle führenden Leerzeichen (bestimmt so, als ob std::iswspace aufgerufen würde), bevor versucht wird, die Eingabe zu parsen. Diese verbrauchten Zeichen zählen nicht zur angegebenen maximalen Feldbreite. Wenn der Längenspezifizierer l nicht verwendet wird, führen die Konvertierungsspezifizierer c, s und [ eine Wide-zu-Multibyte-Zeichenkonvertierung durch, als ob std::wcrtomb mit einem std::mbstate_t-Objekt aufgerufen würde, das vor der Konvertierung des ersten Zeichens auf Null initialisiert wurde. Die Konvertierungsspezifizierer s und [ speichern immer den Nullterminator zusätzlich zu den abgeglichenen Zeichen. Die Größe des Zielarrays muss mindestens um eins größer sein als die angegebene Feldbreite. Die Verwendung von %s oder %[ ohne Angabe der Zielarraygröße ist genauso unsicher wie std::gets. Die korrekten Konvertierungsspezifizierer für die Integer-Typen fester Breite (std::int8_t, etc.) sind im Header <cinttypes> definiert (obwohl SCNdMAX, SCNuMAX, etc. synonym mit %jd, %ju, etc. sind). Nach der Aktion jedes Konvertierungsspezifizierers gibt es einen Sequenzpunkt; dies ermöglicht die Speicherung mehrerer Felder in derselben "Senken"-Variable. Beim Parsen eines unvollständigen Gleitkommawerts, der mit dem Exponenten ohne Ziffern endet, z. B. beim Parsen von "100er" mit dem Konvertierungsspezifizierer %f, wird die Sequenz "100e" (das längste Präfix einer möglicherweise gültigen Gleitkommazahl) verbraucht, was zu einem Abgleichfehler führt (die verbrauchte Sequenz kann nicht in eine Gleitkommazahl konvertiert werden), wobei "r" übrig bleibt. Einige bestehende Implementierungen folgen dieser Regel nicht und rollen zurück, um nur "100" zu verbrauchen und "er" übrig zu lassen, z. B. glibc-Bug 1765. Wenn eine Konversionsspezifikation ungültig ist, ist das Verhalten undefiniert.

Rückgabewert

Anzahl der erfolgreich gelesenen Argumente oder EOF, wenn ein Fehler auftritt, bevor das erste empfangende Argument zugewiesen wurde.

Siehe auch

vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	liest formatierte breite Zeichen-Eingabe von stdin, einem Dateistream oder einem Puffer mit variabler Argumentenliste (Funktion)
C-Dokumentation für wscanf, fwscanf, swscanf