Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

mbrtowc — ponovno pokretljiva višebajtna pretvorba C23

`mbrtowc(pwc, s, n, ps)` iz `<wchar.h>` pregledava najviše `n` bajtova sljedećeg višebajtnog znaka u trenutačnom izvršnom kodiranju. Kada dovrši valjan znak, vraća broj bajtova koji su ga dovršili i uz `pwc != NULL` sprema odgovarajući `wchar_t`; stanje `mbstate_t` označeno s `ps` nastavlja znak preko granica spremnika.

Verzija: C23

Sintaksa

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

mbrtowc(pwc, s, n, ps) iz <wchar.h> pregledava najviše n bajtova sljedećeg višebajtnog znaka u trenutačnom izvršnom kodiranju. Kada dovrši valjan znak, vraća broj bajtova koji su ga dovršili i uz pwc != NULL sprema odgovarajući wchar_t; stanje mbstate_t označeno s ps nastavlja znak preko granica spremnika.

Primjer bira zajamčeni locale "C", izričito inicijalizira stanje nulom i stvarno pretvara jednobajtni "A". Izlaz 1 0041 1 potvrđuje jedan potrošen bajt, vrijednost širokog znaka i prema mbsinit povratak u početno stanje.

0 znači široki nul-znak i početno stanje, (size_t)-2 nepotpun, ali možda valjan znak bez spremanja, a (size_t)-1 pogrešku s errno == EILSEQ, bez spremanja i s neodređenim stanjem. Nakon -2 daj sljedeće bajtove s istim ps; nakon -1 ponovno inicijaliziraj stanje. s == NULL točno odgovara mbrtowc(NULL, "", 1, ps), ps == NULL bira unutarnje stanje bez jamstva protiv data racea, a wchar_t ne mora biti Unicode code point. Kada je s == NULL, zanemaruju se vrijednosti pwc i n koje je predao pozivatelj.

Primjeri

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

Rezultat

1 0041 1

Primjer bira zajamčeni locale `"C"`, izričito inicijalizira stanje nulom i stvarno pretvara jednobajtni `"A"`. Izlaz `1 0041 1` potvrđuje jedan potrošen bajt, vrijednost širokog znaka i prema `mbsinit` povratak u početno stanje.

Izvori