plucky (3) fgetwc.3.gz

Provided by: manpages-de-dev_4.25.1-1_all bug

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.

       ┌────────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │SchnittstelleAttributWert      │
       ├────────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │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⟩.