CKTIS / C
mbrtowc — conversione multibyte riavviabile C23
`mbrtowc(pwc, s, n, ps)` di `<wchar.h>` esamina al massimo `n` byte del prossimo carattere multibyte nella codifica di esecuzione corrente. Quando completa un carattere valido restituisce il numero di byte che lo hanno completato e memorizza il `wchar_t` corrispondente se `pwc != NULL`; il `mbstate_t` indicato da `ps` prosegue un carattere diviso tra buffer.
Versione: C23
Sintassi
size_t mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtowc(pwc, s, n, ps) di <wchar.h> esamina al massimo n byte del prossimo carattere multibyte nella codifica di esecuzione corrente. Quando completa un carattere valido restituisce il numero di byte che lo hanno completato e memorizza il wchar_t corrispondente se pwc != NULL; il mbstate_t indicato da ps prosegue un carattere diviso tra buffer.
L’esempio seleziona la locale garantita "C", inizializza a zero uno stato esplicito e converte davvero il "A" di un byte. L’output 1 0041 1 conferma un byte consumato, il valore del carattere wide e il ritorno allo stato iniziale secondo mbsinit.
Il risultato 0 indica carattere wide nullo e stato iniziale, (size_t)-2 un carattere incompleto ma potenzialmente valido senza scrittura e (size_t)-1 un errore con errno == EILSEQ, senza scrittura e con stato non specificato. Dopo -2, fornisci i byte successivi con lo stesso ps; dopo -1, reinizializza prima di continuare. s == NULL equivale esattamente a mbrtowc(NULL, "", 1, ps), ps == NULL usa stato interno non garantito race-free e wchar_t non deve essere un punto Unicode. Quando s == NULL, i valori pwc e n forniti dal chiamante vengono ignorati.
Esempi
#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;}
Risultato
1 0041 1
L’esempio seleziona la locale garantita `"C"`, inizializza a zero uno stato esplicito e converte davvero il `"A"` di un byte. L’output `1 0041 1` conferma un byte consumato, il valore del carattere wide e il ritorno allo stato iniziale secondo `mbsinit`.