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`.