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

CKTIS / C++

wchar_t — tipo de carácter largo

wchar_t é um tipo inteiro integrado distinto, usado para caracteres largos. O prefixo L cria os literais correspondentes. O tamanho, o sinal e a codificação dependem da implementação, pelo que não é um tipo de carácter Unicode portátil.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

wchar_t ch = L'A';
const wchar_t text[] = L"AB";

wchar_t é uma palavra-chave que designa um tipo de carácter integrado distinto, pertencente aos tipos inteiros. Não é um alias de char, short ou int; a sua declaração não requer qualquer cabeçalho. O seu tipo subjacente é um tipo inteiro com sinal ou sem sinal definido pela implementação, pelo que não se deve pressupor um tamanho ou sinal fixos.

O prefixo L seleciona literais largos: L'A' tem o tipo wchar_t, enquanto L"AB" é um array de três elementos const wchar_t, incluindo o zero final. A declaração const wchar_t text[] = L"AB"; cria um array separado com esses elementos. O número de elementos do array não corresponde ao seu tamanho em bytes.

wchar_t não garante a codificação UTF-16 nem a UTF-32, e um valor individual não deve ser equiparado a qualquer carácter Unicode ou a um carácter tal como é percecionado pelo utilizador. Os literais com os prefixos u e U usam char16_t e char32_t, respetivamente, e não wchar_t. Ao trocar texto entre sistemas, especifique explicitamente a codificação, em vez de tratar os bytes brutos de wchar_t como um formato portátil.

O exemplo verifica o tipo do literal em tempo de compilação, compara valores e conta os elementos do array, incluindo o zero final. Não apresenta texto largo nem o tamanho de wchar_t, pelo que o resultado esperado não depende da largura desse tipo nem do suporte do terminal para texto largo.

Exemplos

#include <iostream>
#include <type_traits>

int main() {
    constexpr wchar_t ch = L'A';
    constexpr wchar_t text[] = L"AB";
    static_assert(std::is_same_v<decltype(L'A'), wchar_t>);
    static_assert(!std::is_same_v<wchar_t, char>);

    std::cout << std::boolalpha << (text[0] == ch) << '\n';
    std::cout << sizeof(text) / sizeof(text[0]) << '\n';
}

Resultado

true
3

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