mbstowcs - Multibyte-Zeichenkette in Langzeichenkette umwandeln

Definition	#include <stdlib.h> size_t mbstowcs(wchar_t *pwcs, const char *s, size_t n); mbstowcs wandelt eine Folge von Multibyte-Zeichen in der Zeichenkette s in die entsprechenden Langzeichen (Typ wchar_t) um und schreibt maximal n Langzeichen 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 NULL-Zeiger, 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 Langzeichen entsprechen den Werten der einzelnen Bytes in der Zeichenkette s.
Returnwert	Anzahl der in pwcs abgespeicherten Langzeichen (ohne das abschließende Nullbyte),
		wenn pwcs kein NULL-Zeiger 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 NULL-Zeiger 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 und Langzeichen haben immer die Länge 1 Byte. Der Shift-Zustand des Multibyte-Zeichens wird ignoriert.
Siehe auch	mblen, mbtowc, wcstombs, wctomb