CKTIS / C++
char16_t — typ jednotky kódu UTF-16
char16_t je vestavěný celočíselný typ určený k ukládání jednotek kódu UTF-16. Jedna hodnota nemusí představovat celý znak Unicode: některé body kódu vyžadují dvojici jednotek kódu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
char16_t unit = u'A';
const char16_t text[] = u"A\U0001F600";char16_t je samostatný vestavěný znakový a celočíselný typ. Jeho základním typem je std::uint_least16_t, ale nejde o jeho alias. Poskytuje alespoň 16 hodnotových bitů; nepředpokládejte, že sizeof(char16_t) == 2. K použití samotného klíčového slova není potřeba žádná hlavička.
Prefix u vytváří literály UTF-16: u'A' má typ char16_t, zatímco u"A" je pole prvků typu const char16_t zakončené nulou. Znak zapsaný ve znakovém literálu se musí vejít do jedné jednotky kódu UTF-16. Proto je u'\U0001F600' neplatné, kdežto u"\U0001F600" je platný řetězcový literál.
Jednotka kódu není totéž co bod kódu ani znak vnímaný uživatelem. V UTF-16 vyžadují body kódu mimo základní vícejazyčnou rovinu dvojici náhradních znaků. Samotný typ char16_t UTF-16 nekontroluje: pole může obsahovat také nespárované náhradní znaky.
Příklad ukládá A a U+1F600: tři jednotky kódu a závěrečnou nulu, tedy celkem čtyři prvky pole. Dělení výrazem sizeof(text[0]) počítá prvky bez předpokladu o velikosti bajtu. Zobrazený výstup pochází z prostředí, ve kterém byl příklad spuštěn, a není zaručen ve všech implementacích. Je-li std::size_t aliasem typu unsigned char, v count - 1 se count celočíselnou promocí převede na int nebo unsigned int a výsledek odčítání se vypíše jako číslo. Je-li naopak std::size_t rozšířený celočíselný typ bez znaménka s vyšší hodností než int, k promoci count nedojde a výběr přetížení operátoru << pro výsledek může být nejednoznačný. Druhý příkaz vloží do výstupního proudu přímo count typu std::size_t. Je-li std::size_t aliasem typu unsigned char, vypíše se znak namísto číslice 4. Ani jeden příkaz nevypisuje text UTF-16 uložený v text. Tento článek se vztahuje k C++23; uvedený web obsahuje průběžně se vyvíjející pracovní návrh, nikoli neměnné vydání C++23.
Příklady
#include <iostream>
int main() {
constexpr char16_t unit = u'A';
constexpr char16_t text[] = u"A\U0001F600";
constexpr auto count = sizeof(text) / sizeof(text[0]);
static_assert(unit == 0x0041);
static_assert(count == 4);
static_assert(text[1] == 0xD83D && text[2] == 0xDE00);
static_assert(text[3] == 0);
std::cout << "code units: " << count - 1 << '\n';
std::cout << "array elements: " << count << '\n';
}
Výsledek
code units: 3 array elements: 4
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.