CKTIS / C
mbrtoc8 — funkcija pretvorbe Unicodea C23
`mbrtoc8(pc8, s, n, ps)` iz C23 `<uchar.h>` pretvara sljedeći višebajtni znak izvršnog kodiranja u uzastopne UTF-8 jedinice tipa `char8_t`; u C23 je `char8_t` isti tip kao `unsigned char`. Pregledava najviše `n` bajtova, a `mbstate_t` čuva djelomičan znak i jedinice na čekanju.
Verzija: C23
Sintaksa
size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc8(pc8, s, n, ps) iz C23 <uchar.h> pretvara sljedeći višebajtni znak izvršnog kodiranja u uzastopne UTF-8 jedinice tipa char8_t; u C23 je char8_t isti tip kao unsigned char. Pregledava najviše n bajtova, a mbstate_t čuva djelomičan znak i jedinice na čekanju.
Primjer koristi izričito stanje i stvarno poziva mbrtoc8 za jednobajtni "!". Funkcija vraća 1, sprema UTF-8 jedinicu 0x21, a izlaz 1 21 provjerava oba učinka. Kod zahtijeva biblioteku C23 koja nudi ovu novostandardiziranu funkciju.
0 znači nul-znak i početno stanje, -2 nepotpun ulaz, -1 pogrešku EILSEQ s neodređenim stanjem, a -3 spremanje sljedeće UTF-8 jedinice prethodnog znaka bez novih bajtova. Nakon -3 ne pomiči s; nakon -2 daj preostale bajtove s istim ps. Kada je s == NULL, poziv točno odgovara mbrtoc8(NULL, "", 1, ps); pc8 i n se zanemaruju. To je propisani poziv s praznim nizom u trenutačnom stanju pretvorbe, a ne obećanje bezuvjetnog reseta. Uz nenulti s, pc8 == NULL preskače samo spremanje; vlastiti ps izbjegava unutarnje stanje bez jamstva protiv data racea.
Primjeri
#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;}
Rezultat
1 21
Primjer koristi izričito stanje i stvarno poziva `mbrtoc8` za jednobajtni `"!"`. Funkcija vraća `1`, sprema UTF-8 jedinicu `0x21`, a izlaz `1 21` provjerava oba učinka. Kod zahtijeva biblioteku C23 koja nudi ovu novostandardiziranu funkciju.