Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

char32_t — tipo carattere per UTF-32

char32_t è un tipo intero distinto integrato nel linguaggio, usato per le unità di codice UTF-32. Il prefisso U crea i corrispondenti letterali carattere e stringa. Il tipo offre almeno 32 bit di valore, ma non convalida Unicode di per sé e non garantisce una dimensione di quattro byte.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

char32_t value = U'\U0001F600';
const char32_t text[] = U"A\U0001F600";

char32_t è un tipo carattere e intero integrato; per dichiararlo non è necessario alcun header. È un tipo distinto, non un alias di unsigned int o std::uint_least32_t. Quest’ultimo è il suo tipo sottostante e offre almeno 32 bit di valore. Non dare quindi per scontato che sizeof(char32_t) == 4.

La U maiuscola è importante: U'\U0001F600' è un letterale di tipo char32_t, mentre U"A\U0001F600" è un array con terminatore zero di elementi const char32_t, codificato in UTF-32. Ha tre elementi: A, U+1F600 e il terminatore. La u minuscola indica UTF-16 e il tipo char16_t, non char32_t.

In UTF-32 ben formato, un’unità di codice rappresenta un valore scalare Unicode. Tuttavia, char32_t è di per sé un tipo intero: può memorizzare anche valori non validi in UTF-32, quindi i dati esterni devono essere convalidati. Il numero di unità di codice non deve necessariamente coincidere con il numero di caratteri percepiti dall’utente.

Nell’ambiente verificato, l’esempio stampa il valore numerico di U+1F600 (128512), seguito dal numero di unità di codice, escluso il terminatore (2). Questo risultato non garantisce la portabilità dell’esempio. Se std::size_t è un tipo intero esteso senza segno con un rango di conversione superiore a quello di int, il risultato resta di tipo std::size_t dopo aver sottratto 1. In questo caso, la scelta del sovraccarico di operator<< per stampare il conteggio può essere ambigua e impedire la compilazione dell’esempio. La conversione a unsigned long serve a stampare un numero, non a codificare testo; per visualizzare il simbolo occorre una codifica separata, adatta all’output. La fonte fornita è una bozza di standard in evoluzione, non una pubblicazione definitiva di C++23.

Esempi

#include <iostream>

int main() {
    constexpr char32_t symbol = U'\U0001F600';
    constexpr char32_t text[] = U"A\U0001F600";
    static_assert(text[1] == symbol);
    static_assert(sizeof(text) / sizeof(text[0]) == 3);

    std::cout << static_cast<unsigned long>(symbol) << '\n';
    std::cout << sizeof(text) / sizeof(text[0]) - 1 << '\n';
}

Risultato

128512
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