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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.