Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti