Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

wchar_t — typ širokých znaků

wchar_t je samostatný vestavěný celočíselný typ používaný pro široké znaky. Prefix L vytváří odpovídající literály. Velikost, znaménkovost a kódování závisejí na implementaci, takže nejde o přenositelný typ znaku Unicode.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

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

wchar_t je klíčové slovo označující samostatný vestavěný znakový typ, který patří mezi celočíselné typy. Není aliasem pro char, short ani int; jeho deklarace nevyžaduje žádnou hlavičku. Jeho základním typem je celočíselný typ se znaménkem nebo bez znaménka, který určuje implementace. Nelze proto předpokládat pevnou velikost ani znaménkovost.

Prefix L označuje široké literály: L'A' má typ wchar_t, zatímco L"AB" je pole tří prvků typu const wchar_t, včetně závěrečné nuly. Deklarace const wchar_t text[] = L"AB"; vytvoří samostatné pole s těmito prvky. Počet prvků pole není jeho velikost v bajtech.

wchar_t nezaručuje kódování UTF-16 ani UTF-32 a jednu hodnotu nelze ztotožňovat s libovolným znakem Unicode nebo znakem vnímaným uživatelem. Literály s prefixy u a U používají char16_t, respektive char32_t, nikoli wchar_t. Při výměně textu mezi systémy výslovně určete kódování; nepovažujte surové bajty wchar_t za přenositelný formát.

Příklad při kompilaci ověřuje typ literálu, porovnává hodnoty a počítá prvky pole včetně závěrečné nuly. Nevypisuje široký text ani velikost wchar_t, takže očekávaný výstup nezávisí na šířce tohoto typu ani na podpoře širokého textu v terminálu.

Příklady

#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';
}

Výsledek

true
3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje