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.