std:: ungetwc

Definiert in Header <cwchar>
std:: wint_t ungetwc ( std:: wint_t ch, std:: FILE * stream ) ;

Wenn ch nicht gleich WEOF ist, schiebt das Breitzeichen ch in den Eingabepuffer, der mit dem Stream stream verbunden ist, auf eine Weise, dass nachfolgende Leseoperationen von stream dieses Breitzeichen abrufen werden. Das externe Gerät, das mit dem Stream verbunden ist, wird nicht modifiziert.

Stream-Positionierungsoperationen std::fseek , std::fsetpos und std::rewind verwerfen die Effekte von std::ungetwc .

Wenn std::ungetwc mehr als einmal ohne zwischengeschriebenes Lesen oder Repositionierung aufgerufen wird, kann es fehlschlagen (mit anderen Worten, ein Pushback-Puffer der Größe 1 ist garantiert, aber jeder größere Puffer ist implementierungsdefiniert). Wenn mehrere erfolgreiche std::ungetwc -Aufrufe durchgeführt wurden, lesen Leseoperationen die zurückgestellten Breitzeichen in umgekehrter Reihenfolge von std::ungetwc

Wenn ch gleich WEOF ist, schlägt der Vorgang fehl und der Stream bleibt unverändert.

Ein erfolgreicher Aufruf von std::ungetwc löscht den End-of-Datei-Statusflag feof .

Ein erfolgreicher Aufruf von std::ungetwc auf einem Stream (ob Text oder Binär) modifiziert den Stream-Positionsindikator auf nicht spezifizierte Weise, garantiert jedoch, dass nach dem Abrufen aller zurückgeschobenen Breitzeichen durch einen Lesevorgang der Stream-Positionsindikator gleich seinem Wert vor std::ungetwc ist.

Parameter

ch	-	Breites Zeichen, das zurückgestellt werden soll
stream	-	Dateistrom, zu dem das breite Zeichen zurückgestellt werden soll

Rückgabewert

Bei Erfolg wird ch zurückgegeben.

Bei Fehler wird WEOF zurückgegeben und der gegebene Stream bleibt unverändert.

Siehe auch

ungetc	setzt ein Zeichen in einen Dateistrom zurück (Funktion)
fgetwc getwc	liest ein Breitzeichen aus einem Dateistrom (Funktion)
C-Dokumentation für ungetwc