Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje