CKTIS / C
<uchar.h> — pripomočki za Unicode
Glava <uchar.h> ponuja tipe za kodne enote Unicode in funkcije za pretvorbo med ustreznimi oblikami UTF in večbajtnim kodiranjem trenutne področne nastavitve LC_CTYPE.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <uchar.h><uchar.h> deklarira char8_t, char16_t, char32_t, size_t in mbstate_t. Pri pretvorbah prvi trije tipi predstavljajo kodne enote UTF-8, UTF-16 in UTF-32 v tem vrstnem redu. Kodna enota ne predstavlja vedno celotnega znaka.
Dvojice mbrtoc8/c8rtomb, mbrtoc16/c16rtomb in mbrtoc32/c32rtomb pretvarjajo med večbajtnim kodiranjem trenutne področne nastavitve LC_CTYPE in ustrezno obliko UTF. Kodiranje, izbrano med prevajanjem za navadne literale, ne določa večbajtnega kodiranja, ki ga uporabljajo te funkcije. Ne predpostavljajte, da je trenutno večbajtno kodiranje UTF-8; med povezanimi klici ohranite stanje mbstate_t.
Primer prešteje kodne enote literala UTF-8 brez zaključne ničle, neodvisno od področne nastavitve. Ne kliče nobene od teh pretvorbenih funkcij. Zastavica prevajalnika v repozitoriju ne potrjuje podpore v produkcijskem izvajalnem okolju.
Primeri
#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;
}
Rezultat
2
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju prav te različice.