Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

mbrtoc8 — funkcia prevodu Unicode C23

`mbrtoc8(pc8, s, n, ps)` z C23 `<uchar.h>` prevádza ďalší viacbajtový znak vykonávacieho kódovania na postupné jednotky UTF-8 typu `char8_t`; v C23 je `char8_t` rovnaký typ ako `unsigned char`. Preskúma najviac `n` bajtov a `mbstate_t` zachová čiastočný znak aj čakajúce jednotky.

Verzia: C23

Syntax

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> prevádza ďalší viacbajtový znak vykonávacieho kódovania na postupné jednotky UTF-8 typu char8_t; v C23 je char8_t rovnaký typ ako unsigned char. Preskúma najviac n bajtov a mbstate_t zachová čiastočný znak aj čakajúce jednotky.

Príklad používa vlastný stav a skutočne volá mbrtoc8 pre jednobajtové "!". Funkcia vráti 1, uloží jednotku UTF-8 0x21 a výstup 1 21 overuje oba účinky. Kód vyžaduje knižnicu C23, ktorá túto novo štandardizovanú funkciu poskytuje.

0 označuje nulový znak a počiatočný stav, -2 neúplný vstup, -1 chybu EILSEQ s nešpecifikovaným stavom a -3 uloženie ďalšej jednotky UTF-8 predchádzajúceho znaku bez nových bajtov. Po -3 neposúvajte s; po -2 dodajte zvyšné bajty s rovnakým ps. Pri s == NULL volanie presne zodpovedá mbrtoc8(NULL, "", 1, ps); pc8 a n sa ignorujú. Ide o predpísané volanie s prázdnym reťazcom v aktuálnom stave prevodu, nie o prísľub bezpodmienečného resetu. Pri nenulovom s hodnota pc8 == NULL potlačí iba uloženie; vlastný ps sa vyhne internému stavu bez záruky proti dátovým pretekom.

Príklady

#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;}

Výsledok

1 21

Príklad používa vlastný stav a skutočne volá `mbrtoc8` pre jednobajtové `"!"`. Funkcia vráti `1`, uloží jednotku UTF-8 `0x21` a výstup `1 21` overuje oba účinky. Kód vyžaduje knižnicu C23, ktorá túto novo štandardizovanú funkciu poskytuje.

Zdroje