Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje