База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

<uchar.h> — помощни средства за Unicode

Заглавният файл <uchar.h> предоставя типове за кодови единици на Unicode и функции за преобразуване между съответните UTF формати и многобайтовото кодиране на текущата локална настройка LC_CTYPE.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <uchar.h>

<uchar.h> декларира char8_t, char16_t, char32_t, size_t и mbstate_t. При преобразуванията първите три типа представят кодови единици съответно на UTF-8, UTF-16 и UTF-32. Една кодова единица невинаги представлява цял знак.

Двойките mbrtoc8/c8rtomb, mbrtoc16/c16rtomb и mbrtoc32/c32rtomb преобразуват между многобайтовото кодиране на текущата локална настройка LC_CTYPE и съответния UTF формат. Кодирането, избрано при компилация за обикновените литерали, не определя многобайтовото кодиране, което използват тези функции. Не приемайте, че текущото многобайтово кодиране е UTF-8; запазвайте състоянието на mbstate_t между свързани извиквания.

Примерът брои кодовите единици в UTF-8 литерал без завършващата нулева единица, независимо от локалните настройки. Той не извиква нито една от тези функции за преобразуване. Флагът на компилатора в хранилището не потвърждава поддръжката в продукционната среда за изпълнение.

Примери

#include <stdio.h>
#include <uchar.h>

#if !defined(__STDC_VERSION_UCHAR_H__)
typedef unsigned char char8_t;
#endif

int main(void)
{
    const char8_t text[] = u8"é";
    const size_t units = sizeof text / sizeof text[0] - 1;
    printf("%zu\n", units);
    return 0;
}

Резултат

2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници