CKTIS / C
mbrtoc16 — funzione di conversione Unicode C23
`mbrtoc16(pc16, s, n, ps)` di `<uchar.h>` esamina al massimo `n` byte del prossimo carattere multibyte di esecuzione e memorizza la corrispondente unità UTF-16 `char16_t`. L’oggetto `mbstate_t` indicato da `ps` conserva lo stato tra le chiamate; `pc16 == NULL` sopprime solo la scrittura.
Versione: C23
Sintassi
size_t mbrtoc16(char16_t * restrict pc16, const char * restrict s, size_t n, mbstate_t * restrict ps);mbrtoc16(pc16, s, n, ps) di <uchar.h> esamina al massimo n byte del prossimo carattere multibyte di esecuzione e memorizza la corrispondente unità UTF-16 char16_t. L’oggetto mbstate_t indicato da ps conserva lo stato tra le chiamate; pc16 == NULL sopprime solo la scrittura.
L’esempio usa uno stato inizializzato esplicitamente a zero e converte "A" di un byte. La funzione consuma un byte, memorizza U+0041 e il programma stampa 1 U+0041; verifica quindi il vero valore di ritorno e l’unità UTF-16.
Il risultato 0 indica il carattere nullo e lo stato iniziale, -2 un carattere incompleto ma potenzialmente valido e -1 un errore di codifica con errno == EILSEQ e stato non specificato. Fuori dal BMP si ottiene una coppia surrogata: la prima chiamata consuma byte, una successiva può restituire -3 e memorizzare l’unità seguente senza consumare input; allora non avanzare s. Quando s == NULL, la chiamata equivale esattamente a mbrtoc16(NULL, "", 1, ps); pc16 e n sono ignorati. È la chiamata specificata con stringa vuota nello stato corrente, non una promessa di reset incondizionato. Con s non nullo, pc16 == NULL sopprime solo la scrittura; un ps esplicito evita lo stato interno non garantito race-free.
Esempi
#include <stdio.h>
#include <uchar.h>
int main(void){mbstate_t state={0};char16_t unit=0;size_t count=mbrtoc16(&unit,"A",1,&state);printf("%zu U+%04X\n",count,(unsigned)unit);return 0;}
Risultato
1 U+0041
L’esempio usa uno stato inizializzato esplicitamente a zero e converte `"A"` di un byte. La funzione consuma un byte, memorizza `U+0041` e il programma stampa `1 U+0041`; verifica quindi il vero valore di ritorno e l’unità UTF-16.