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 Schiebe-Zustand, 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-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       C99, POSIX.1-2001.

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.9.1                              2. Mai 2024                                          btowc(3)