Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mbrtoc8 — funzione di conversione Unicode C23

`mbrtoc8(pc8, s, n, ps)` di `<uchar.h>` C23 converte il prossimo carattere multibyte di esecuzione in unità UTF-8 `char8_t` successive; in C23, `char8_t` è lo stesso tipo di `unsigned char`. Esamina al massimo `n` byte e `mbstate_t` conserva un carattere parziale e unità in attesa.

Versione: C23

Sintassi

size_t mbrtoc8(char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps);

mbrtoc8(pc8, s, n, ps) di <uchar.h> C23 converte il prossimo carattere multibyte di esecuzione in unità UTF-8 char8_t successive; in C23, char8_t è lo stesso tipo di unsigned char. Esamina al massimo n byte e mbstate_t conserva un carattere parziale e unità in attesa.

L’esempio usa uno stato esplicito e chiama davvero mbrtoc8 per "!" di un byte. La funzione restituisce 1, memorizza l’unità UTF-8 0x21 e l’output 1 21 verifica entrambi gli effetti. Il codice richiede una libreria C23 che fornisca questa funzione appena standardizzata.

0 indica carattere nullo e stato iniziale, -2 input incompleto, -1 errore EILSEQ con stato non specificato e -3 memorizzazione di un’altra unità UTF-8 del carattere precedente senza nuovi byte. Non avanzare s dopo -3; dopo -2, fornisci i byte restanti con lo stesso ps. Quando s == NULL, la chiamata equivale esattamente a mbrtoc8(NULL, "", 1, ps); pc8 e n sono ignorati. È la chiamata specificata con stringa vuota nello stato corrente, non una promessa di reset incondizionato. Con s non nullo, pc8 == 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};char8_t unit=0;size_t count=mbrtoc8(&unit,"!",1,&state);printf("%zu %02X\n",count,(unsigned)unit);return 0;}

Risultato

1 21

L’esempio usa uno stato esplicito e chiama davvero `mbrtoc8` per `"!"` di un byte. La funzione restituisce `1`, memorizza l’unità UTF-8 `0x21` e l’output `1 21` verifica entrambi gli effetti. Il codice richiede una libreria C23 che fornisca questa funzione appena standardizzata.

Fonti