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.