table of contents
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
wctomb(3) | Library Functions Manual | wctomb(3) |
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.
Schnittstelle | Attribut | Wert |
wctomb() | Multithread-Fähigkeit | MT-Unsicher race |
STANDARDS¶
POSIX.1-2001, POSIX.1-2008, C99.
ANMERKUNGEN¶
Das Verhalten von wctomb() hängt von der Kategorie LC_CTYPE der aktuellen Locale ab.
Die Funktion wcrtomb(3) stellt eine bessere Schnittstelle für die gleiche Funktionalität bereit.
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.
15. Dezember 2022 | Linux man-pages 6.03 |