CKTIS / C
mbrtoc32 — funkce převodu Unicode C23
`mbrtoc32(pc32, s, n, ps)` z `<uchar.h>` převede nejvýše `n` bajtů dalšího vícebajtového znaku prováděcího kódování na jednotku UTF-32 typu `char32_t`. Stav `mbstate_t` umožní pokračovat ve znaku rozděleném mezi buffery; nulové `pc32` stále převádí, jen neukládá.
Verze: C23
Syntaxe
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> převede nejvýše n bajtů dalšího vícebajtového znaku prováděcího kódování na jednotku UTF-32 typu char32_t. Stav mbstate_t umožní pokračovat ve znaku rozděleném mezi buffery; nulové pc32 stále převádí, jen neukládá.
Příklad předá nulově inicializovaný stav a jednobajtový řetězec "Z". mbrtoc32 vrátí počet spotřebovaných bajtů 1, uloží U+0000005A a celý výstup je 1 U+0000005A.
Návrat 0 značí nulový znak a obnovení počátečního stavu; -2 žádá další bajty, -1 znamená EILSEQ a nechá stav neurčený, zatímco -3 může dodat další výsledek předchozího znaku bez spotřeby vstupu. Po -2 pokračujte zbylými bajty a stejným ps; po -3 vstup neposouvejte. Při s == NULL volání přesně odpovídá mbrtoc32(NULL, "", 1, ps); pc32 a n se ignorují. Jde o předepsané volání s prázdným řetězcem v aktuálním stavu převodu, nikoli o slib bezpodmínečného resetu. Při nenulovém s hodnota pc32 == NULL potlačí jen uložení; vlastní ps se vyhne internímu stavu bez záruky proti datovým závodům.
Pří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ýsledek
1 U+0000005A
Příklad předá nulově inicializovaný stav a jednobajtový řetězec `"Z"`. `mbrtoc32` vrátí počet spotřebovaných bajtů `1`, uloží `U+0000005A` a celý výstup je `1 U+0000005A`.