Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

<uchar.h> — utilità Unicode

L’header <uchar.h> fornisce tipi per le unità di codice Unicode e funzioni di conversione tra i corrispondenti formati UTF e la codifica multibyte della locale LC_CTYPE corrente.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <uchar.h>

<uchar.h> dichiara char8_t, char16_t, char32_t, size_t e mbstate_t. Nelle conversioni, i primi tre tipi rappresentano le unità di codice di UTF-8, UTF-16 e UTF-32, rispettivamente. Un’unità di codice non rappresenta sempre un carattere intero.

Le coppie mbrtoc8/c8rtomb, mbrtoc16/c16rtomb e mbrtoc32/c32rtomb convertono tra la codifica multibyte della locale LC_CTYPE corrente e il formato UTF corrispondente. La codifica scelta in fase di compilazione per i letterali ordinari non determina la codifica multibyte usata da queste funzioni. Non dare per scontato che la codifica multibyte corrente sia UTF-8; conserva lo stato di mbstate_t tra chiamate correlate.

L’esempio conta le unità di codice di un letterale UTF-8 senza includere il terminatore, indipendentemente dalle impostazioni locali. Non chiama nessuna di queste funzioni di conversione. Il flag del compilatore nel repository non attesta che l’ambiente di esecuzione in produzione supporti queste funzioni.

Esempi

#include <stdio.h>
#include <uchar.h>

#if !defined(__STDC_VERSION_UCHAR_H__)
typedef unsigned char char8_t;
#endif

int main(void)
{
    const char8_t text[] = u8"é";
    const size_t units = sizeof text / sizeof text[0] - 1;
    printf("%zu\n", units);
    return 0;
}

Risultato

2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti