CKTIS / C
mbrtoc32 — C23-Unicode-Konvertierungsfunktion
`mbrtoc32(pc32, s, n, ps)` aus `<uchar.h>` wandelt höchstens `n` Bytes des nächsten Multibytezeichens der Ausführungsumgebung in eine UTF-32-Einheit vom Typ `char32_t` um. Der `mbstate_t`-Zustand setzt ein über Puffer geteiltes Zeichen fort; ein null-`pc32` konvertiert weiter, speichert aber nicht.
Version: C23
Syntax
size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc32(pc32, s, n, ps) aus <uchar.h> wandelt höchstens n Bytes des nächsten Multibytezeichens der Ausführungsumgebung in eine UTF-32-Einheit vom Typ char32_t um. Der mbstate_t-Zustand setzt ein über Puffer geteiltes Zeichen fort; ein null-pc32 konvertiert weiter, speichert aber nicht.
Das Beispiel übergibt einen nullinitialisierten Zustand und das einbyteige "Z". mbrtoc32 liefert die verbrauchte Bytezahl 1, speichert U+0000005A, und die vollständige Ausgabe lautet 1 U+0000005A.
0 bezeichnet das Nullzeichen und die Rückkehr in den Anfangszustand; -2 fordert weitere Bytes an, -1 bedeutet EILSEQ und lässt den Zustand unbestimmt, während -3 ein weiteres Ergebnis des vorherigen Zeichens ohne Eingabeverbrauch liefern kann. Nach -2 mit Restbytes und demselben ps fortfahren; nach -3 die Eingabe nicht vorrücken. Bei s == NULL entspricht der Aufruf exakt mbrtoc32(NULL, "", 1, ps); pc32 und n werden ignoriert. Dies ist der festgelegte Aufruf mit leerer Zeichenfolge im aktuellen Konvertierungszustand, keine Zusage eines bedingungslosen Resets. Bei nicht-null s unterdrückt pc32 == NULL nur das Speichern; eigener ps vermeidet den internen Zustand ohne Race-Freiheitsgarantie.
Beispiele
#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}
Ergebnis
1 U+0000005A
Das Beispiel übergibt einen nullinitialisierten Zustand und das einbyteige `"Z"`. `mbrtoc32` liefert die verbrauchte Bytezahl `1`, speichert `U+0000005A`, und die vollständige Ausgabe lautet `1 U+0000005A`.