BEZEICHNUNG

wcstombs - Eine Zeichenkette weiter Zeichen in eine Multibyte-Zeichenkette konvertieren

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <stdlib.h>

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 höchstens n byte geschrieben. Die in Ziel abgelegte Zeichensequenz beginnt im anfänglichen Schiebe-Zustand. Die Konvertierung kann aus drei Gründen stoppen:

•

Es wurde auf ein weites Zeichen gestossen, das nicht als Multibyte-Sequenz dargestellt werden kann (gemäß der aktuellen Locale). In diesem Fall wird (size_t) -1 zurückgeliefert.

•

Die Längenbegrenzung erzwingt einen Stopp. In diesem Fall wird die Anzahl der nach Ziel geschriebenen Bytes zurückgeliefert, aber der Schiebe-Zustand geht an diesem Punkt verloren.

•

Die Zeichenkette weiter Zeichen wurde vollständig umgewandelt, einschließlich des abschließenden weiten Nullzeichens (L'\0'). In diesem Fall endet die Umwandlung im anfänglichen Schiebe-Zustand. Es wird die Anzahl der nach Ziel geschriebenen Bytes ohne das abschließende Nullbyte (»\0«) zurückgeliefert.

Der Programmierer muss sicherstellen, dass bei Ziel Platz für mindestens n byte ist.

Falls Ziel NULL ist, wird n ignoriert und die Umwandlung fährt wie oben fort, außer dass die umgewandelten Bytes nicht in den Speicher geschrieben werden und keine Längenbeschränkung existiert.

Um den obigen zweiten Fall zu vermeiden, sollte der Programmierer sicherstellen, dass n größer oder gleich wcstombs(NULL,Quelle,0)+1 ist.

RÜCKGABEWERT

Die Funktion wcstombs() liefert die Anzahl der Bytes zurück, die den umgewandelten Teil der Multibyte-Sequenz darstellen, ohne das abschließende Nullbyte. Falls ein weites Zeichen angetroffen wurde, das nicht umgewandelt werden konnte, wird (size_t) -1 zurückgeliefert.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

VERSIONEN

Die Funktion wcsrtombs(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 wcstombs() hängt von der Kategorie LC_CTYPE der aktuellen Locale ab.

SIEHE AUCH

mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(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.