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⟩.