wctomb(3) Library Functions Manual wctomb(3) BEZEICHNUNG wctomb - Konvertiert ein weites Zeichen in eine Multibyte-Sequenz BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include 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 Lange der besagten Multibyte-Darstellung zuruck, d.h. die Anzahl der nach z geschriebenen Byte. Hochstens MB_CUR_MAX byte werden nach z geschrieben. Der Programmierer muss sicherstellen, dass es genug Raum gibt, um die Multibyte-Sequenz unter z zu schreiben. Falls z NULL ist, setzt wctomb() den nur dieser Funktion bekannten Schiebe-Zustand auf den anfanglichen Zustand zuruck und liefert einen von Null verschiedenen Wert zuruck, falls die Kodierung einen nicht trivialen Schiebe-Zustand hat oder Null, falls die Kodierung zustandsfrei ist. RUCKGABEWERT Falls z nicht NULL ist, dann liefert wctomb() die Anzahl der in das Byte-Feld unter z geschriebenen Byte zuruck. Falls wz nicht als Multibyte-Sequenz (gemass der aktuellen Locale) dargestellt werden kann, wird -1 zuruckgeliefert. Falls z NULL ist, liefert wctomb() einen von Null verschiedenen Wert zuruck, falls die Kodierung einen nicht trivialen Schiebe-Zustand hat oder Null, falls die Kodierung zustandsfrei ist. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |wctomb() | Multithread-Fahigkeit | MT-Unsicher race | +-------------------------+-------------------------+------------------+ VERSIONEN Die Funktion wcrtomb(3) stellt eine bessere Schnittstelle fur die gleiche Funktionalitat bereit. STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von wctomb() hangt 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) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.18 8. Februar 2026 wctomb(3)