Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

<uchar.h> — narzędzia Unicode

Nagłówek <uchar.h> udostępnia typy jednostek kodowych Unicode oraz funkcje konwersji między odpowiednimi formatami UTF a kodowaniem wielobajtowym określonym przez bieżące ustawienie regionalne LC_CTYPE.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <uchar.h>

<uchar.h> deklaruje char8_t, char16_t, char32_t, size_t i mbstate_t. W konwersjach trzy pierwsze typy reprezentują jednostki kodowe odpowiednio UTF-8, UTF-16 i UTF-32. Jednostka kodowa nie zawsze reprezentuje cały znak.

Pary mbrtoc8/c8rtomb, mbrtoc16/c16rtomb i mbrtoc32/c32rtomb konwertują między kodowaniem wielobajtowym określonym przez bieżące ustawienie regionalne LC_CTYPE a odpowiednim formatem UTF. Kodowania wielobajtowego używanego przez te funkcje nie wyznacza wybór kodowania zwykłych literałów na etapie kompilacji. Nie zakładaj, że bieżące kodowanie wielobajtowe to UTF-8; zachowuj stan mbstate_t między powiązanymi wywołaniami.

Przykład zlicza jednostki kodowe literału UTF-8 bez terminatora, niezależnie od ustawień regionalnych. Nie wywołuje żadnej z tych funkcji konwersji. Flaga kompilatora w repozytorium nie potwierdza obsługi w środowisku produkcyjnym.

Przykłady

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

Wynik

2

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła