Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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`.

Źródła