fgetwc(3)

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.