wcstombs(3) Library Functions Manual wcstombs(3) BEZEICHNUNG wcstombs - Eine Zeichenkette weiter Zeichen in eine Multibyte-Zeichenkette konvertieren BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include size_t wcstombs(char Ziel[restrict .n], const wchar_t *restrict Quelle, size_t n); BESCHREIBUNG Falls Ziel nicht NULL ist, konvertiert die Funktion wcstombs() die Zeichenkette weiter Zeichen Quelle in eine bei Ziel beginnende Multibyte-Zeichenkette. Es werden nach Ziel hochstens n byte geschrieben. Die in Ziel abgelegte Zeichensequenz beginnt im anfanglichen Schiebe-Zustand. Die Konvertierung kann aus drei Grunden stoppen: o Es wurde auf ein weites Zeichen gestossen, das nicht als Multibyte-Sequenz dargestellt werden kann (gemass der aktuellen Locale). In diesem Fall wird (size_t) -1 zuruckgeliefert. o Die Langenbegrenzung erzwingt einen Stopp. In diesem Fall wird die Anzahl der nach Ziel geschriebenen Bytes zuruckgeliefert, aber der Schiebe-Zustand geht an diesem Punkt verloren. o Die Zeichenkette weiter Zeichen wurde vollstandig umgewandelt, einschliesslich des abschliessenden weiten Nullzeichens (L'\0'). In diesem Fall endet die Umwandlung im anfanglichen Schiebe-Zustand. Es wird die Anzahl der nach Ziel geschriebenen Bytes ohne das abschliessende Nullbyte (>>\0<<) zuruckgeliefert. Der Programmierer muss sicherstellen, dass bei Ziel Platz fur mindestens n byte ist. Falls Ziel NULL ist, wird n ignoriert und die Umwandlung fahrt wie oben fort, ausser dass die umgewandelten Bytes nicht in den Speicher geschrieben werden und keine Langenbeschrankung existiert. Um den obigen zweiten Fall zu vermeiden, sollte der Programmierer sicherstellen, dass n grosser oder gleich wcstombs(NULL,Quelle,0)+1 ist. RUCKGABEWERT Die Funktion wcstombs() liefert die Anzahl der Bytes zuruck, die den umgewandelten Teil der Multibyte-Sequenz darstellen, ohne das abschliessende Nullbyte. Falls ein weites Zeichen angetroffen wurde, das nicht umgewandelt werden konnte, wird (size_t) -1 zuruckgeliefert. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |wcstombs() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ VERSIONEN Die Funktion wcsrtombs(3) stellt eine bessere Schnittstelle fur die gleiche Funktionalitat bereit. STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten von wcstombs() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. SIEHE AUCH mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(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.06 31. Oktober 2023 wcstombs(3)