CKTIS / C
mbrtowc — restartowalna konwersja wielobajtowa C23
`mbrtowc(pwc, s, n, ps)` z `<wchar.h>` bada najwyżej `n` bajtów następnego znaku wielobajtowego bieżącego kodowania wykonawczego. Po ukończeniu poprawnego znaku zwraca liczbę bajtów, które go dopełniły, i zapisuje odpowiadający `wchar_t`, o ile `pwc != NULL`; stan `mbstate_t` w `ps` pozwala kontynuować znak podzielony między bufory.
Wersja: C23
Składnia
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> bada najwyżej n bajtów następnego znaku wielobajtowego bieżącego kodowania wykonawczego. Po ukończeniu poprawnego znaku zwraca liczbę bajtów, które go dopełniły, i zapisuje odpowiadający wchar_t, o ile pwc != NULL; stan mbstate_t w ps pozwala kontynuować znak podzielony między bufory.
Przykład ustawia gwarantowane locale "C", zeruje jawny stan i naprawdę konwertuje jednobajtowe "A". Wynik 1 0041 1 potwierdza zużycie jednego bajtu, wartość szerokiego znaku oraz powrót stanu do stanu początkowego według mbsinit.
Wynik 0 oznacza szeroki znak null i stan początkowy, (size_t)-2 oznacza niepełny, potencjalnie poprawny znak bez zapisu, a (size_t)-1 błąd z errno == EILSEQ, bez zapisu i z nieokreślonym stanem. Po -2 podaj kolejne bajty z tym samym ps; po -1 nie kontynuuj bez ponownej inicjalizacji. s == NULL jest dokładnie równoważne mbrtowc(NULL, "", 1, ps), ps == NULL wybiera wewnętrzny stan bez gwarancji braku data race, a wchar_t nie musi być kodem Unicode. Przy s == NULL przekazane przez wywołującego wartości pwc i n są ignorowane.
Przykłady
#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;}
Wynik
1 0041 1
Przykład ustawia gwarantowane locale `"C"`, zeruje jawny stan i naprawdę konwertuje jednobajtowe `"A"`. Wynik `1 0041 1` potwierdza zużycie jednego bajtu, wartość szerokiego znaku oraz powrót stanu do stanu początkowego według `mbsinit`.