CKTIS / C
<uchar.h> — nástroje Unicode
Hlavička <uchar.h> poskytuje typy pro jednotky kódu Unicode a funkce pro převod mezi příslušnými formáty UTF a vícebajtovým kódováním aktuálního národního prostředí LC_CTYPE.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <uchar.h><uchar.h> deklaruje char8_t, char16_t, char32_t, size_t a mbstate_t. Při převodech představují první tři typy jednotky kódu UTF-8, UTF-16 a UTF-32 v tomto pořadí. Jednotka kódu nemusí vždy představovat celý znak.
Dvojice mbrtoc8/c8rtomb, mbrtoc16/c16rtomb a mbrtoc32/c32rtomb převádějí mezi vícebajtovým kódováním aktuálního národního prostředí LC_CTYPE a příslušným formátem UTF. Kódování zvolené při překladu pro běžné literály neurčuje, jaké vícebajtové kódování tyto funkce používají. Nepředpokládejte, že aktuální vícebajtové kódování je UTF-8; mezi souvisejícími voláními zachovávejte stav mbstate_t.
Příklad počítá jednotky kódu v literálu UTF-8 bez ukončovacího prvku, nezávisle na národním prostředí. Nevolá žádnou z těchto převodních funkcí. Příznak překladače v repozitáři nepotvrzuje podporu v produkčním běhovém prostředí.
Příklady
#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;
}
Výsledek
2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření právě této verze.