Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

mbrtoc8 — funkcija pretvorbe Unicode C23

`mbrtoc8(pc8, s, n, ps)` iz C23 `<uchar.h>` pretvori naslednji večbajtni znak izvedbenega kodiranja v zaporedne enote UTF-8 tipa `char8_t`; v C23 je `char8_t` isti tip kot `unsigned char`. Pregleda največ `n` bajtov, `mbstate_t` pa ohrani delni znak in čakajoče enote.

Različica: 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> pretvori naslednji večbajtni znak izvedbenega kodiranja v zaporedne enote UTF-8 tipa char8_t; v C23 je char8_t isti tip kot unsigned char. Pregleda največ n bajtov, mbstate_t pa ohrani delni znak in čakajoče enote.

Primer uporabi izrecno stanje in dejansko pokliče mbrtoc8 za enobajtni "!". Funkcija vrne 1, shrani enoto UTF-8 0x21, izhod 1 21 pa preveri oba učinka. Koda zahteva knjižnico C23, ki ponuja to novo standardizirano funkcijo.

0 pomeni ničelni znak in začetno stanje, -2 nepopoln vhod, -1 napako EILSEQ z nedoločenim stanjem in -3 shranitev naslednje enote UTF-8 prejšnjega znaka brez novih bajtov. Po -3 ne premaknite s; po -2 podajte preostale bajte z istim ps. Pri s == NULL je klic natančno enakovreden mbrtoc8(NULL, "", 1, ps); pc8 in n se prezreta. To je predpisani klic s praznim nizom v trenutnem stanju pretvorbe, ne obljuba brezpogojne ponastavitve. Pri neničelnem s vrednost pc8 == NULL izpusti le shranjevanje; lasten ps se izogne notranjemu stanju brez jamstva pred podatkovnimi tekmami.

Primeri

#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

Primer uporabi izrecno stanje in dejansko pokliče `mbrtoc8` za enobajtni `"!"`. Funkcija vrne `1`, shrani enoto UTF-8 `0x21`, izhod `1 21` pa preveri oba učinka. Koda zahteva knjižnico C23, ki ponuja to novo standardizirano funkcijo.

Viri