BEZEICHNUNG

       btowc - einzelne Bytes in weite Zeichen konvertieren

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <wchar.h>

       wint_t btowc(int z);

BESCHREIBUNG

       Die  Funktion  btowc()  konvertiert  z,  interpretiert  als  Multibytesequenz  der  Länge 1, beginnend am
       anfänglichen Verschiebungszustand, in ein weites Zeichen und liefert dies zurück. Falls z EOF oder  keine
       gültige Multibyte-Sequenz der Länge 1 ist, liefert die Funktion btowc() WEOF zurück.

RÜCKGABEWERT

       Die  Funktion  btowc() liefert das weite Zeichen, das aus dem einzelnen Byte z konvertiert wurde, zurück.
       Falls z EOF oder keine gültige Multibyte-Sequenz der Länge 1 ist, liefert sie WEOF zurück.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌─────────────────────────────────────────────────────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle                                                       │ Attribut              │ Wert    │
       ├─────────────────────────────────────────────────────────────────────┼───────────────────────┼─────────┤
       │ btowc()                                                             │ Multithread-Fähigkeit │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001, POSIX.1-2008, C99.

ANMERKUNGEN

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

       Diese Funktion sollte niemals verwandt werden. Sie funktioniert für Kodierungen, die über Zustand  verfü‐
       gen,  nicht  und  behandelt  unnötigerweise  einzelne Bytes anders als Multibyte-Sequenzen. Verwenden Sie
       stattdessen entweder mbtowc(3) oder das Thread-sichere mbrtowc(3).

SIEHE AUCH

       mbrtowc(3), mbtowc(3), wctob(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 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.

Linux man-pages 6.03                            15. Dezember 2022                                       btowc(3)