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 │
       └────────────────────────────────────────────────────────────┴───────────────────────┴──────────────────┘

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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                         wctomb(3)