CKTIS / C++
std::wstring — uma cadeia de elementos wchar_t
std::wstring é um alias de std::basic_string<wchar_t>, definido em <string>. Gere o armazenamento da cadeia e permite acrescentar texto, comparar e aceder a elementos. Não garante uma codificação Unicode portátil.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <string>
std::wstring text = L"Hello";std::wstring é um alias de std::basic_string<wchar_t> de <string>. Armazena contiguamente uma sequência de elementos wchar_t, gere o respetivo tempo de vida e permite alterar o comprimento da cadeia. O prefixo L cria literais wide: L"cat" é um literal de cadeia e L'C' é um literal de carácter.
size() devolve o número de elementos wchar_t armazenados, sem contar o elemento nulo final. Em geral, este número não corresponde ao número de pontos de código Unicode nem ao de caracteres percecionados pelo utilizador. A largura de wchar_t e a codificação dos literais wide dependem da implementação; std::wstring não garante UTF-16 nem UTF-32. Também não converte automaticamente texto de std::string.
O operador += acrescenta texto, enquanto at(i) permite aceder a um elemento com verificação dos limites e lança std::out_of_range quando i >= size(). O método c_str() disponibiliza um apontador para dados terminados em zero, útil para interfaces que aceitam const wchar_t*. Uma cadeia também pode conter zeros incorporados, mas uma interface que dependa exclusivamente de um terminador tratará o primeiro como o fim do texto.
O exemplo cria L"cat", acrescenta L"s" e altera o primeiro elemento. Usa std::cout para imprimir apenas o comprimento e o resultado da comparação, pelo que não é necessário apresentar texto wide no terminal. As linhas esperadas são 4 e 1. Esta descrição abrange operações disponíveis em C++23; a fonte indicada é um projeto de norma em evolução, não uma publicação C++23 definitiva.
Exemplos
#include <iostream>
#include <string>
int main() {
std::wstring text = L"cat";
text += L"s";
text.at(0) = L'C';
std::cout << text.size() << '\n';
std::cout << (text == L"Cats") << '\n';
}
Resultado
4 1
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.