CKTIS / C
<uchar.h> — nástroje Unicode
Hlavička <uchar.h> poskytuje typy jednotiek kódu Unicode a funkcie na konverziu medzi príslušnými formátmi UTF a viacbajtovým kódovaním podľa aktuálneho miestneho nastavenia LC_CTYPE.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <uchar.h><uchar.h> deklaruje char8_t, char16_t, char32_t, size_t a mbstate_t. Pri konverziách predstavujú prvé tri typy jednotky kódu UTF-8, UTF-16 a UTF-32 v tomto poradí. Jednotka kódu nemusí vždy predstavovať celý znak.
Dvojice mbrtoc8/c8rtomb, mbrtoc16/c16rtomb a mbrtoc32/c32rtomb konvertujú medzi viacbajtovým kódovaním podľa aktuálneho miestneho nastavenia LC_CTYPE a príslušným formátom UTF. Kódovanie zvolené pri kompilácii pre bežné literály neurčuje, aké viacbajtové kódovanie tieto funkcie používajú. Nepredpokladajte, že aktuálne viacbajtové kódovanie je UTF-8; medzi súvisiacimi volaniami zachovávajte stav mbstate_t.
Príklad počíta jednotky kódu v literáli UTF-8 bez ukončovacieho prvku, nezávisle od miestneho nastavenia. Nevolá žiadnu z týchto konverzných funkcií. Príznak kompilátora v repozitári nepotvrdzuje podporu v produkčnom prostredí behu programu.
Prí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ýsledok
2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v doklade o overení práve tejto verzie.