ungetwc

Definiert in Header <wchar.h>
wint_t ungetwc ( wint_t ch, FILE * stream ) ;		(seit C95)

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

Stream-Positionierungsoperationen fseek , fsetpos und rewind machen die Effekte von ungetwc zunichte.

Wenn ungetwc mehr als einmal ohne dazwischenliegendes Lesen oder Repositionieren 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 ungetwc -Operationen durchgeführt wurden, lesen Leseoperationen die zurückgestellten Breitzeichen in umgekehrter Reihenfolge von ungetwc

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

Ein erfolgreicher Aufruf von ungetwc löscht den End-of-File-Statusindikator feof .

Ein erfolgreicher Aufruf von 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 ungetwc ist.

Inhaltsverzeichnis 1 Parameter 2 Rückgabewert 3 Referenzen 4 Siehe auch

Parameter

ch	-	Breites Zeichen, das zurückgelegt werden soll
stream	-	Dateistream, in den das breite Zeichen zurückgelegt werden soll

Rückgabewert

Bei Erfolg wird ch zurückgegeben.

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

Referenzen