CKTIS / C++
std::u8string — uma cadeia de unidades de código UTF-8
std::u8string é um alias de std::basic_string<char8_t> de <string>. Armazena unidades de código UTF-8, mas não valida a codificação; size() não conta os caracteres percecionados pelo utilizador.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <string>
std::u8string text = u8"...";
// Alias: std::basic_string<char8_t>std::u8string, de <string>, é um alias de std::basic_string<char8_t>. Gere armazenamento contíguo e permite alterar o comprimento da cadeia. Inicialize-a com um literal UTF-8, por exemplo, std::u8string text = u8"A\u00E9";. O prefixo u8 produz um literal cujos elementos são do tipo char8_t.
size() e o acesso por índice referem-se a unidades de código, não a pontos de código Unicode nem a caracteres percecionados pelo utilizador. No exemplo, A, é e ! ocupam, ao todo, quatro unidades UTF-8. Uma operação num índice individual pode dividir a codificação de várias unidades de um carácter. O contentor não valida UTF-8 nem efetua normalização Unicode.
c_str() expõe um const char8_t*; o zero final não está incluído em size(). Não é um const char*: std::u8string não se converte implicitamente em std::string e não pode ser escrito diretamente com std::cout << text. A integração com uma interface baseada em char exige o tratamento explícito da representação e do contrato de codificação.
Esta entrada tem como referência C++23. A norma de compilação especificada pelo repositório não comprova a compatibilidade com o ambiente de execução de produção. A fonte eel.is é um rascunho em evolução, não uma publicação C++23 imutável.
Exemplos
#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';
}
Resultado
code units: 4 terminator: 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.