Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mbrtoc32 — funzione di conversione Unicode C23

`mbrtoc32(pc32, s, n, ps)` di `<uchar.h>` converte al massimo `n` byte del prossimo carattere multibyte di esecuzione in un’unità UTF-32 `char32_t`. Lo stato `mbstate_t` permette di continuare un carattere diviso tra buffer; un `pc32` nullo esegue comunque la conversione ma non memorizza.

Versione: C23

Sintassi

size_t mbrtoc32(char32_t * restrict pc32, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc32(pc32, s, n, ps) di <uchar.h> converte al massimo n byte del prossimo carattere multibyte di esecuzione in un’unità UTF-32 char32_t. Lo stato mbstate_t permette di continuare un carattere diviso tra buffer; un pc32 nullo esegue comunque la conversione ma non memorizza.

L’esempio passa uno stato inizializzato a zero e la stringa "Z" di un byte. mbrtoc32 restituisce il conteggio dei byte consumati 1, memorizza U+0000005A e l’output completo è 1 U+0000005A.

Il ritorno 0 indica il carattere nullo e il ripristino dello stato iniziale; -2 richiede altri byte, -1 significa EILSEQ e lascia lo stato non specificato, mentre -3 può fornire un altro risultato del carattere precedente senza consumare input. Dopo -2, continua con i byte rimanenti e lo stesso ps; dopo -3, non avanzare l’input. Quando s == NULL, la chiamata equivale esattamente a mbrtoc32(NULL, "", 1, ps); pc32 e n sono ignorati. È la chiamata specificata con stringa vuota nello stato corrente, non una promessa di reset incondizionato. Con s non nullo, pc32 == 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};char32_t unit=0;size_t count=mbrtoc32(&unit,"Z",1,&state);printf("%zu U+%08X\n",count,(unsigned)unit);return 0;}

Risultato

1 U+0000005A

L’esempio passa uno stato inizializzato a zero e la stringa `"Z"` di un byte. `mbrtoc32` restituisce il conteggio dei byte consumati `1`, memorizza `U+0000005A` e l’output completo è `1 U+0000005A`.

Fonti