Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes