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.