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.

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.