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

CKTIS / C

mbrtoc32 — funkcia prevodu Unicode C23

`mbrtoc32(pc32, s, n, ps)` z `<uchar.h>` prevedie najviac `n` bajtov ďalšieho viacbajtového znaku vykonávacieho kódovania na jednotku UTF-32 typu `char32_t`. Stav `mbstate_t` umožní pokračovať v znaku rozdelenom medzi buffery; nulové `pc32` stále konvertuje, len neukladá.

Verzia: C23

Syntax

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> prevedie najviac n bajtov ďalšieho viacbajtového znaku vykonávacieho kódovania na jednotku UTF-32 typu char32_t. Stav mbstate_t umožní pokračovať v znaku rozdelenom medzi buffery; nulové pc32 stále konvertuje, len neukladá.

Príklad odovzdá nulovo inicializovaný stav a jednobajtový reťazec "Z". mbrtoc32 vráti počet spotrebovaných bajtov 1, uloží U+0000005A a celý výstup je 1 U+0000005A.

Návrat 0 označuje nulový znak a obnovenie počiatočného stavu; -2 žiada ďalšie bajty, -1 znamená EILSEQ a nechá stav nešpecifikovaný, kým -3 môže dodať ďalší výsledok predchádzajúceho znaku bez spotreby vstupu. Po -2 pokračujte zvyšnými bajtmi a rovnakým ps; po -3 vstup neposúvajte. Pri s == NULL volanie presne zodpovedá mbrtoc32(NULL, "", 1, ps); pc32 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 pc32 == 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};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}

Výsledok

1 U+0000005A

Príklad odovzdá nulovo inicializovaný stav a jednobajtový reťazec `"Z"`. `mbrtoc32` vráti počet spotrebovaných bajtov `1`, uloží `U+0000005A` a celý výstup je `1 U+0000005A`.

Zdroje