CKTIS / C
mbrtowc — рестартируемо многобайтово преобразуване в C23
`mbrtowc(pwc, s, n, ps)` от `<wchar.h>` преглежда най-много `n` байта от следващия многобайтов знак в текущото изпълнимо кодиране. Когато завърши валиден знак, връща броя байтове, които са го завършили, и при `pwc != NULL` записва съответния `wchar_t`; състоянието `mbstate_t`, сочено от `ps`, продължава знак през граници на буфери.
Версия: C23
Синтаксис
size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtowc(pwc, s, n, ps) от <wchar.h> преглежда най-много n байта от следващия многобайтов знак в текущото изпълнимо кодиране. Когато завърши валиден знак, връща броя байтове, които са го завършили, и при pwc != NULL записва съответния wchar_t; състоянието mbstate_t, сочено от ps, продължава знак през граници на буфери.
Примерът избира гарантирания locale "C", нулево инициализира явно състояние и действително преобразува еднобайтовото "A". Изходът 1 0041 1 потвърждава един консумиран байт, стойността на широкия знак и според mbsinit връщане в начално състояние.
0 означава широк нулев знак и начално състояние, (size_t)-2 — непълен, но потенциално валиден знак без запис, а (size_t)-1 — грешка с errno == EILSEQ, без запис и с неуточнено състояние. След -2 подайте следващи байтове със същия ps; след -1 инициализирайте отново. s == NULL е точно еквивалентно на mbrtowc(NULL, "", 1, ps), ps == NULL избира вътрешно състояние без гаранция срещу data race, а wchar_t не е задължително Unicode кодова точка. Когато s == NULL, подадените от извикващия стойности pwc и n се игнорират.
Примери
#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;}
Резултат
1 0041 1
Примерът избира гарантирания locale `"C"`, нулево инициализира явно състояние и действително преобразува еднобайтовото `"A"`. Изходът `1 0041 1` потвърждава един консумиран байт, стойността на широкия знак и според `mbsinit` връщане в начално състояние.