BEZEICHNUNG

ungetwc - Ein weites Zeichen auf einen FILE-Datenstrom zurückschieben

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <wchar.h>

wint_t ungetwc(wint_t wz, FILE *Datenstrom);

BESCHREIBUNG

Die Funktion ungetwc() ist das Äquivalent der Funktion ungetc(3) für weite Zeichen. Sie schiebt ein weites Zeichen auf Datenstrom zurück und liefert es zurück.

Falls wz WEOF ist, liefert sie WEOF zurück. Falls wz ein ungültiges weites Zeichen ist, setzt sie errno auf EILSEQ und liefert WEOF zurück.

Falls wz ein gültiges weites Zeichen ist, dann wird es auf den Datenstrom zurückgeschoben und wird daher für zukünftige Leseaktionen für weite Zeichen verfügbar. Der Dateipositionsanzeiger wird um einen oder mehrere verringert. Der Dateiendeanzeiger wird bereinigt. Der zugrundeliegende Speicher der Datei ist davon nicht betroffen.

Hinweis: wz muss nicht das zuletzt aus dem Datenstrom gelesene weite Zeichen sein. Es kann jedes andere gültige weite Zeichen sein.

Falls die Implementierung mehrere Rückschiebeaktionen auf einmal unterstützt, werden die zurückgeschobenen weiten Zeiten in umgekehrter Reihenfolge gelesen. Es wird allerdings nur eine Stufe an Rückschiebungen garantiert.

RÜCKGABEWERT

Die Funktion ungetwc() liefert im Erfolgsfall wz zurück oder WEOF beim Fehlschlag.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS

C11, POSIX.1-2008.

GESCHICHTE

POSIX.1-2001, C99.

ANMERKUNGEN

Das Verhalten von ungetwc() hängt von der Kategorie LC_CTYPE der aktuellen Locale ab.

SIEHE AUCH

fgetwc(3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.