wcrtomb - Langzeichen in Multibyte-Zeichen umwandeln

Definition	#include <wchar.h> size_t wcrtomb(char *s, wchar_t wc, mbstate_t *ps);
Beschreibung	Wenn s ein Nullzeiger ist, entspricht wcrtomb() dem Aufruf wcrtomb(buf, L'\0', ps) wobei buf einen internen Puffer bezeichnet. Wenn s kein Nullzeiger ist, bestimmt wcrtomb() die Anzahl der Bytes, die unter Berücksichtigung eventueller Umschalt-Sequenzen zur Darstellung des wc entsprechenden Multibyte-Zeichens benötigt werden. Die Ergebnisbytes werden in das Feld geschrieben, auf dessen erstes Element s zeigt. Es werden maximal {MB_CUR_MAX} Bytes geschrieben. Ist wc ein Nullzeichen, wird ein Nullbyte geschrieben, dem eine Umschalt-Sequenz vorausgehen kann, die den „initial shift“-Zustand wiederherstellt. Der Ergebniszustand entspricht dem „initial conversion“ Zustand.
Returnwert	(size_t)-1	wenn wc kein gültiges Langzeichen darstellt. In errno wird der Wert des Makros EILSEQ geschrieben. Der Konversions-Zustand ist undefiniert.
	Anzahl der in das Feld *s geschriebenen Bytes
		sonst
Hinweis	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(), wcstombs(), wctomb().