CKTIS / C
mbrtoc32 — funkcja konwersji Unicode C23
`mbrtoc32(pc32, s, n, ps)` z `<uchar.h>` przetwarza najwyżej `n` bajtów następnego znaku w kodowaniu wykonawczym na jednostkę UTF-32 typu `char32_t`. Stan `mbstate_t` pozwala kontynuować znak podzielony między bufory; null w `pc32` nadal wykonuje konwersję, lecz nie zapisuje jednostki.
Wersja: C23
Składnia
size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc32(pc32, s, n, ps) z <uchar.h> przetwarza najwyżej n bajtów następnego znaku w kodowaniu wykonawczym na jednostkę UTF-32 typu char32_t. Stan mbstate_t pozwala kontynuować znak podzielony między bufory; null w pc32 nadal wykonuje konwersję, lecz nie zapisuje jednostki.
Przykład przekazuje wyzerowany stan oraz jednobajtowe "Z". mbrtoc32 zwraca liczbę zużytych bajtów 1, zapisuje U+0000005A, a pełny wynik programu to 1 U+0000005A.
Zwrócone 0 oznacza znak null i przywrócenie stanu początkowego; -2 wymaga dalszych bajtów, -1 oznacza EILSEQ i pozostawia stan nieokreślony, a -3 może dostarczyć kolejny wynik wcześniejszego znaku bez zużycia wejścia. Po -2 kontynuuj z pozostałymi bajtami w tym samym ps; po -3 nie przesuwaj wejścia. Gdy s == NULL, wywołanie jest dokładnie równoważne mbrtoc32(NULL, "", 1, ps); parametry pc32 i n są ignorowane. Jest to określone wywołanie z pustym napisem w bieżącym stanie konwersji, a nie obietnica bezwarunkowego resetu. Przy nie-nullowym s wartość pc32 == NULL pomija tylko zapis; jawny ps omija stan wewnętrzny bez gwarancji braku data race.
Przykłady
#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;}
Wynik
1 U+0000005A
Przykład przekazuje wyzerowany stan oraz jednobajtowe `"Z"`. `mbrtoc32` zwraca liczbę zużytych bajtów `1`, zapisuje `U+0000005A`, a pełny wynik programu to `1 U+0000005A`.