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

CKTIS / C

mbrtowc — reštartovateľný viacbajtový prevod C23

`mbrtowc(pwc, s, n, ps)` z `<wchar.h>` preskúma najviac `n` bajtov ďalšieho viacbajtového znaku v aktuálnom vykonávacom kódovaní. Po dokončení platného znaku vráti počet bajtov, ktoré ho dokončili, a pri `pwc != NULL` uloží zodpovedajúci `wchar_t`; stav `mbstate_t` určený `ps` pokračuje v znaku rozdelenom medzi buffery.

Verzia: C23

Syntax

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> preskúma najviac n bajtov ďalšieho viacbajtového znaku v aktuálnom vykonávacom kódovaní. Po dokončení platného znaku vráti počet bajtov, ktoré ho dokončili, a pri pwc != NULL uloží zodpovedajúci wchar_t; stav mbstate_t určený ps pokračuje v znaku rozdelenom medzi buffery.

Príklad zvolí zaručené locale "C", výslovne nulovo inicializuje stav a skutočne prevedie jednobajtové "A". Výstup 1 0041 1 potvrdzuje jeden spotrebovaný bajt, hodnotu širokého znaku a podľa mbsinit návrat do počiatočného stavu.

0 označuje široký nulový znak a počiatočný stav, (size_t)-2 neúplný, ale potenciálne platný znak bez uloženia a (size_t)-1 chybu s errno == EILSEQ, bez uloženia a s nešpecifikovaným stavom. Po -2 dodajte ďalšie bajty s rovnakým ps; po -1 stav pred pokračovaním inicializujte. s == NULL presne zodpovedá mbrtowc(NULL, "", 1, ps), ps == NULL volí interný stav bez záruky proti dátovým pretekom a wchar_t nemusí byť bod Unicode. Keď s == NULL, hodnoty pwc a n odovzdané volajúcim sa ignorujú.

Prí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ýsledok

1 0041 1

Príklad zvolí zaručené locale `"C"`, výslovne nulovo inicializuje stav a skutočne prevedie jednobajtové `"A"`. Výstup `1 0041 1` potvrdzuje jeden spotrebovaný bajt, hodnotu širokého znaku a podľa `mbsinit` návrat do počiatočného stavu.

Zdroje