BEZEICHNUNG

       fgetwc, getwc - Ein weites Zeichen aus einem FILE-Datenstrom lesen

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <stdio.h>
       #include <wchar.h>

       wint_t fgetwc(FILE *Datenstrom);
       wint_t getwc(FILE *Datenstrom);

BESCHREIBUNG

       Die  Funktion  fgetwc()  ist  das  Äquivalent der Funktion fgetc(3) für weite Zeichen. Sie
       liest ein weites Zeichen aus  Datenstrom  und  liefert  es  zurück.  Falls  das  Ende  des
       Datenstroms erreicht ist oder falls ferror(Datenstrom) wahr wird, liefert sie WEOF zurück.
       Falls ein Fehler bei der Umwandlung in weite Zeichen auftritt, setzt sie errno auf  EILSEQ
       und liefert WEOF zurück.

       Die  Funktion  oder  das  Makro  getwc() funktionieren identisch zu fgetwc(). Sie kann als
       Makro implementiert sein und wertet ihre Argumente mehrfach aus. Es gibt keinen Grund, sie
       jemals zu verwenden.

       Für nicht sperrende Gegenstücke siehe unlocked_stdio(3).

RÜCKGABEWERT

       Im  Erfolgsfall  liefert  fgetwc()  das  nächste  weite  Zeichen  vom  Datenstrom  zurück.
       Andernfalls wird WEOF zurückgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

       Abgesehen von den normalen gibt es

       EILSEQ Die vom Datenstrom erlangten Daten ergeben kein gültiges Zeichen.

ATTRIBUTE

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

       ┌─────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │Schnittstelle                                        │ Attribut              │ Wert      │
       ├─────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │fgetwc(), getwc()                                    │ Multithread-Fähigkeit │ MT-Sicher │
       └─────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       POSIX.1-2001, C99.

ANMERKUNGEN

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

       Da keine  zusätzlichen  Informationen  an  den  Aufruf  fopen(3)  übergeben  werden,  kann
       vernünftigerweise  erwartet  werden,  dass fgetwc() tatsächlich eine Multibyte-Sequenz aus
       dem Datenstrom liest und sie dann in ein weites Zeichen konvertiert.

SIEHE AUCH

       fgetws(3), fputwc(3), ungetwc(3), unlocked_stdio(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⟩.