ungetwc(3)

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.
Schnittstelle | Attribut | Wert
ungetwc() | Multithread-Fähigkeit | MT-Sicher

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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: debian-l10n-german@lists.debian.org.