CKTIS / C++
char16_t — тип за UTF-16 кодова единица
char16_t е вграден целочислен тип, предназначен за съхраняване на UTF-16 кодови единици. Една стойност не представя непременно цял Unicode знак: някои кодови точки изискват двойка кодови единици.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
char16_t unit = u'A';
const char16_t text[] = u"A\U0001F600";char16_t е отделен вграден знаков и целочислен тип. Основният му тип е std::uint_least16_t, но char16_t не е псевдоним на този тип. Осигурява поне 16 бита за стойност; не приемайте, че sizeof(char16_t) == 2. За използването на самата ключова дума не е необходим хедър.
Префиксът u създава UTF-16 литерали: u'A' е от тип char16_t, а u"A" е завършен с нулев знак масив от елементи const char16_t. Знакът в знаковия литерал трябва да се побира в една UTF-16 кодова единица. Затова u'\U0001F600' е невалиден, докато u"\U0001F600" е валиден низов литерал.
Кодовата единица не е същото като кодова точка или знак, възприеман от потребителя. В UTF-16 кодовите точки извън Основната многоезична равнина изискват сурогатна двойка. Самият тип char16_t не проверява UTF-16: масивът може да съдържа и несдвоени сурогати.
Примерът съхранява A и U+1F600: три кодови единици плюс завършваща нула, тоест общо четири елемента на масива. Делението на sizeof(text[0]) преброява елементите, без да предполага определен размер на байта. Показаният изход е получен в средата, в която е изпълнен примерът, и не е гарантиран при всички реализации. Ако std::size_t е псевдоним на unsigned char, в count - 1 типът на count се повишава до int или unsigned int, а резултатът от изваждането се извежда като число. Ако обаче std::size_t е разширен целочислен тип без знак с ранг, по-висок от този на int, типът на count не се повишава и изборът на претоварване на << за резултата може да е нееднозначен. Вторият оператор подава директно в изходния поток count от тип std::size_t. Ако std::size_t е псевдоним на unsigned char, се извежда знак вместо цифрата 4. Нито един от двата оператора не извежда UTF-16 текста, съхранен в text. Тази статия е за C++23; посоченият сайт съдържа развиващ се работен проект, а не окончателна публикация на C++23.
Примери
#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';
}
Резултат
code units: 3 array elements: 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.