Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::u8string — una stringa di unità di codice UTF-8

std::u8string è un alias di std::basic_string<char8_t> definito in <string>. Memorizza unità di codice UTF-8, ma non verifica la validità della codifica; size() non conta i caratteri percepiti dall’utente.

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

Sintassi

#include <string>
std::u8string text = u8"...";
// Alias: std::basic_string<char8_t>

std::u8string, definito in <string>, è un alias di std::basic_string<char8_t>. Gestisce memoria contigua e consente di modificare la lunghezza della stringa. Inizializzalo con un letterale UTF-8, per esempio std::u8string text = u8"A\u00E9";. Il prefisso u8 produce un letterale con elementi di tipo char8_t.

size() e l’accesso tramite indice riguardano le unità di codice, non i punti di codice Unicode né i caratteri percepiti dall’utente. Nell’esempio, A, é e ! occupano complessivamente quattro unità UTF-8. Un’operazione su un singolo indice può dividere la codifica composta da più unità di un carattere. Il contenitore non convalida UTF-8 né esegue la normalizzazione Unicode.

c_str() espone un const char8_t*; lo zero finale non è incluso in size(). Non è un const char*: std::u8string non si converte implicitamente in std::string e non può essere stampato direttamente con std::cout << text. L’integrazione con un’interfaccia basata su char richiede una gestione esplicita della rappresentazione e del contratto di codifica.

Questa voce si riferisce a C++23. Lo standard di compilazione specificato dal repository non dimostra la compatibilità con l’ambiente di esecuzione di produzione. La fonte eel.is è una bozza in evoluzione, non una pubblicazione C++23 definitiva.

Esempi

#include <iostream>
#include <string>

int main() {
    std::u8string text = u8"A\u00E9";
    text += u8"!";
    std::cout << "code units: " << text.size() << '\n';
    std::cout << "terminator: "
              << static_cast<unsigned int>(text.c_str()[text.size()])
              << '\n';
}

Risultato

code units: 4
terminator: 0

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