CKTIS / C
mbrtoc8 — funkcja konwersji Unicode C23
`mbrtoc8(pc8, s, n, ps)` z C23 `<uchar.h>` konwertuje następny znak wielobajtowy kodowania wykonawczego na kolejne jednostki UTF-8 typu `char8_t`; w C23 `char8_t` jest tym samym typem co `unsigned char`. Funkcja bada najwyżej `n` bajtów, a `mbstate_t` zachowuje częściowy znak i oczekujące jednostki.
Wersja: C23
Składnia
size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc8(pc8, s, n, ps) z C23 <uchar.h> konwertuje następny znak wielobajtowy kodowania wykonawczego na kolejne jednostki UTF-8 typu char8_t; w C23 char8_t jest tym samym typem co unsigned char. Funkcja bada najwyżej n bajtów, a mbstate_t zachowuje częściowy znak i oczekujące jednostki.
Przykład używa jawnego stanu i naprawdę wywołuje mbrtoc8 dla jednobajtowego "!". Funkcja zwraca 1, zapisuje jednostkę UTF-8 0x21, a wynik 1 21 sprawdza oba efekty. Kod wymaga implementacji biblioteki C23 udostępniającej tę nową funkcję.
0 oznacza znak null i stan początkowy, -2 niepełne wejście, -1 błąd EILSEQ z nieokreślonym stanem, a -3 zapis kolejnej jednostki UTF-8 wcześniejszego znaku bez zużycia nowych bajtów. Po -3 nie przesuwaj s; po -2 podaj pozostałe bajty z tym samym ps. Gdy s == NULL, wywołanie jest dokładnie równoważne mbrtoc8(NULL, "", 1, ps); parametry pc8 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ść pc8 == 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};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}
Wynik
1 21
Przykład używa jawnego stanu i naprawdę wywołuje `mbrtoc8` dla jednobajtowego `"!"`. Funkcja zwraca `1`, zapisuje jednostkę UTF-8 `0x21`, a wynik `1 21` sprawdza oba efekty. Kod wymaga implementacji biblioteki C23 udostępniającej tę nową funkcję.