BEZEICHNUNG¶

wctomb - Konvertiert ein weites Zeichen in eine Multibyte-Sequenz

BIBLIOTHEK¶

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT¶

#include <stdlib.h>

int wctomb(char *z, wchar_t wz);

BESCHREIBUNG¶

Falls z nicht NULL ist, konvertiert die Funktion wctomb() das weite Zeichen wz in seine Multibyte-Darstellung und speichert sie am Anfang des Zeichenfeldes, auf das z zeigt. Sie aktualisiert den Verschiebe-Zustand, der in einer statischen anonymen Variable gespeichert wird, die nur der Funktion wctomb() bekannt ist, und liefert die Länge der besagten Multibyte-Darstellung zurück, d.h. die Anzahl der nach z geschriebenen Byte.

Der Programmierer muss sicherstellen, dass es bei z Raum für mindestens MB_CUR_MAX byte gibt.

Falls z NULL ist, setzt wctomb() den nur dieser Funktion bekannten Schiebe-Zustand auf den anfänglichen Zustand zurück und liefert einen von Null verschiedenen Wert zurück, falls die Kodierung einen nicht trivialen Schiebe-Zustand hat oder Null, falls die Kodierung zustandsfrei ist.

RÜCKGABEWERT¶

Falls z nicht NULL ist, dann liefert wctomb() die Anzahl der in das Byte-Feld unter z geschriebenen Byte zurück. Falls wz nicht als Multibyte-Sequenz (gemäß der aktuellen Locale) dargestellt werden kann, wird -1 zurückgeliefert.

Falls z NULL ist, liefert wctomb() einen von Null verschiedenen Wert zurück, falls die Kodierung einen nicht trivialen Schiebe-Zustand hat oder Null, falls die Kodierung zustandsfrei ist.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

VERSIONEN¶

Die Funktion wcrtomb(3) stellt eine bessere Schnittstelle für die gleiche Funktionalität bereit.

STANDARDS¶

C11, POSIX.1-2008.

GESCHICHTE¶

POSIX.1-2001, C99.

ANMERKUNGEN¶

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

SIEHE AUCH¶

MB_CUR_MAX(3), mblen(3), mbstowcs(3), mbtowc(3), wcrtomb(3), wcstombs(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.