wcstombs - Langzeichenkette in Zeichenkette umwandeln

Definition	#include <stdlib.h> size_t wcstombs(char *s, const wchar_t *pwcs, size_t n);
Beschreibung	wcstombs() wandelt eine Folge von wchar_t-Werten in pwcs in die entsprechenden Mul-tibyte-Zeichen um und speichert diese in die Zeichenkette s. n gibt die maximale Anzahl Bytes an, die in s abgespeichert werden sollen. 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. Mit wcstombs() wird jeder wchar_t-Wert (Typ long) in pwcs einem 1 Byte langen Bereich in der Zeichenkette s zugewiesen. Die Zuweisung wird beendet, wenn: der wchar_t-Wert 0 in pwcs auftritt, bereits n Bytes zugewiesen wurden oder ein wchar_t-Wert nicht in einem Byte dargestellt werden kann.
Returnwert	Anzahl der zugewiesenen Bytes
		bei erfolgreicher Umwandlung.
	(size_t)-1	wenn ein wchar_t-Wert nicht in ein Multibyte-Zeichen umgewandelt werden kann.
Hinweise	Wenn ein wchar_t-Wert in pwcs nicht in ein Multibyte-Zeichen umgewandelt werden kann, werden die bereits vorher umgewandelten wchar_t-Werte in s abgespeichert. Bei sich überlappenden Speicherbereichen ist das Verhalten undefiniert. Einschränkung In dieser Version des C-Laufzeitsystems werden nur 1-Byte-Zeichen als Langzeichen unterstützt. Sie sind vom Typ wchar_t (siehe stddef.h). (Ende)
Siehe auch	mblen(), mbtowc(), mbstowcs(), wctomb(), stdlib.h.