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.