c32rtomb - UTF-32-Zeichen in Multibyte-Zeichen umwandeln

Definition	C11 #include <uchar.h> size_t c32rtomb(char *s, char32_t c32, mbstate_t *ps); (Ende)
Beschreibung	Wenn s ein Nullzeiger ist, entspricht c32rtomb() dem Aufruf c32rtomb(buf, U'\0', ps) wobei buf einen internen Puffer bezeichnet. Wenn s kein Nullzeiger ist, bestimmt c32rtomb() die Anzahl der Bytes, die unter Berücksichtigung eventueller Umschalt-Sequenzen zur Darstellung des dem UTF-32-Zeichen c32 entsprechenden Multibyte-Zeichens benötigt werden. Die Ergebnisbytes werden in das Feld geschrieben, auf dessen erstes Element s zeigt. Ist c32 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 c32 keinem gültigen Multibyte-Zeichen entspricht, d.h., wenn gilt: c32 > 255. 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 Multibyte-Zeichen unterstützt. (Ende)
Siehe auch	c16rtomb(), mbrtoc16(), mbrtoc32().