mbstowcs - Multibyte-Zeichenkette in Langzeichenkette umwandeln

Definition	#include <stdlib.h> size_t mbstowcs(wchar_t *pwcs, const char *s, size_t n);
Beschreibung	mbstowcs() wandelt eine Folge von Multibyte-Zeichen in der Zeichenkette s in die entsprechenden wchar_t-Werte um und speichert maximal n wchar_t-Werte in den Bereich pwcs. mbstowcs() wandelt um, bis entweder n Werte konvertiert sind oder der Wert Null auftritt (Null wird in den wchar_t-Wert 0 konvertiert). Ist pwcs ein Nullzeiger, gibt mbstowcs() unabhängig vom Wert n die Länge zurück, die benötigt wird, um die gesamte Zeichenkette umzuwandeln, aber speichert keine Werte. Wenn ein ungültiges Zeichen auftritt, liefert mbstowcs() den Wert (size_t)-1 zurück. Die von mbstowcs() im Bereich pwcs abgespeicherten wchar_t-Werte (Typ long) entsprechen den Werten der einzelnen Bytes in der Zeichenkette s.
Returnwert	Anzahl der in pwcs abgespeicherten wchar_t-Werte (ohne das abschließende Nullbyte),
		wenn pwcs kein Nullzeiger ist. Wenn der Returnwert dem Wert n entspricht, ist der Ergebnisbereich pwcs nicht mit dem Nullbyte abgeschlossen.
	Länge, die benötigt wird, um die gesamte Zeichenkette umzuwandeln,
		wenn pwcs ein Nullzeiger ist. Es werden keine Werte gespeichert.
	(size_t)-1	bei Fehler.
Hinweise	Bei sich überlappenden Speicherbereichen ist das Verhalten undefiniert. In dieser Version sind Zeichen, die aus mehreren Bytes bestehen, nicht realisiert. Multibyte- Zeichen haben immer die Länge 1 Byte und wchar_t-Werte sind immer long-Werte.
Siehe auch	mblen(), mbtowc(), wcstombs(), wctomb(), stdlib.h.