CKTIS / C++
char16_t — tip enote kode UTF-16
char16_t je vgrajeni celoštevilski tip, namenjen shranjevanju enot kode UTF-16. Ena vrednost ne predstavlja nujno celotnega znaka Unicode: nekatere kodne točke zahtevajo par enot kode.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
char16_t unit = u'A';
const char16_t text[] = u"A\U0001F600";char16_t je samostojen vgrajeni znakovni in celoštevilski tip. Njegov osnovni tip je std::uint_least16_t, vendar ni njegov vzdevek. Zagotavlja vsaj 16 vrednostnih bitov; ne predpostavljajte, da velja sizeof(char16_t) == 2. Za uporabo same ključne besede ne potrebujete glave.
Predpona u ustvari literale UTF-16: u'A' je tipa char16_t, medtem ko je u"A" z ničlo zaključeno polje elementov const char16_t. Znak, zapisan v znakovnem literalu, se mora prilegati eni enoti kode UTF-16. Zato je u'\U0001F600' neveljaven, u"\U0001F600" pa je veljaven nizovni literal.
Enota kode ni isto kot kodna točka ali znak, kot ga zazna uporabnik. V UTF-16 kodne točke zunaj osnovne večjezične ravnine zahtevajo par nadomestnih znakov. Tip char16_t sam ne preverja veljavnosti UTF-16: polje lahko vsebuje tudi neparne nadomestne znake.
Primer shrani A in U+1F600: tri enote kode in zaključno ničlo, skupaj torej štiri elemente polja. Deljenje z sizeof(text[0]) prešteje elemente, ne da bi predpostavljalo določeno velikost bajta. Prikazani izpis je nastal v okolju, v katerem je bil primer izveden, in ni zagotovljen v vseh implementacijah. Če je std::size_t vzdevek za unsigned char, se count v izrazu count - 1 s celoštevilsko promocijo pretvori v int ali unsigned int, rezultat odštevanja pa se izpiše kot število. Če pa je std::size_t razširjeni nepredznačeni celoštevilski tip z višjim rangom kot int, se count ne promovira in izbira preobremenitve operatorja << za rezultat je lahko dvoumna. Drugi stavek neposredno vstavi count tipa std::size_t v izhodni tok. Če je std::size_t vzdevek za unsigned char, se izpiše znak namesto števke 4. Nobeden od stavkov ne izpiše besedila UTF-16, shranjenega v text. Ta vnos se nanaša na C++23; navedeno spletišče gosti razvijajoči se delovni osnutek, ne nespremenljive objave C++23.
Primeri
#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';
}
Rezultat
code units: 3 array elements: 4
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.