Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

mbrtowc — restartovatelný vícebajtový převod C23

`mbrtowc(pwc, s, n, ps)` z `<wchar.h>` prozkoumá nejvýše `n` bajtů dalšího vícebajtového znaku v aktuálním prováděcím kódování. Po dokončení platného znaku vrátí počet bajtů, které jej dokončily, a při `pwc != NULL` uloží odpovídající `wchar_t`; stav `mbstate_t` určený `ps` pokračuje ve znaku rozděleném mezi buffery.

Verze: C23

Syntaxe

size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtowc(pwc, s, n, ps) z <wchar.h> prozkoumá nejvýše n bajtů dalšího vícebajtového znaku v aktuálním prováděcím kódování. Po dokončení platného znaku vrátí počet bajtů, které jej dokončily, a při pwc != NULL uloží odpovídající wchar_t; stav mbstate_t určený ps pokračuje ve znaku rozděleném mezi buffery.

Příklad zvolí zaručené locale "C", výslovně nulově inicializuje stav a skutečně převede jednobajtové "A". Výstup 1 0041 1 potvrzuje jeden spotřebovaný bajt, hodnotu širokého znaku a podle mbsinit návrat do počátečního stavu.

0 značí široký nulový znak a počáteční stav, (size_t)-2 neúplný, ale potenciálně platný znak bez uložení a (size_t)-1 chybu s errno == EILSEQ, bez uložení a s neurčeným stavem. Po -2 dodejte další bajty se stejným ps; po -1 stav před pokračováním inicializujte. s == NULL přesně odpovídá mbrtowc(NULL, "", 1, ps), ps == NULL volí interní stav bez záruky proti datovým závodům a wchar_t nemusí být bod Unicode. Když s == NULL, hodnoty pwc a n předané volajícím se ignorují.

Příklady

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void){setlocale(LC_CTYPE,"C");mbstate_t state={0};wchar_t wc=0;size_t n=mbrtowc(&wc,"A",1,&state);printf("%zu %04lX %d\n",n,(unsigned long)wc,mbsinit(&state)!=0);return 0;}

Výsledek

1 0041 1

Příklad zvolí zaručené locale `"C"`, výslovně nulově inicializuje stav a skutečně převede jednobajtové `"A"`. Výstup `1 0041 1` potvrzuje jeden spotřebovaný bajt, hodnotu širokého znaku a podle `mbsinit` návrat do počátečního stavu.

Zdroje