KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

<uchar.h> — Unicode-hulpmiddelen

De header <uchar.h> biedt typen voor Unicode-code-eenheden en functies die converteren tussen de bijbehorende UTF-formaten en de multibytecodering van de huidige LC_CTYPE-instelling.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <uchar.h>

<uchar.h> declareert char8_t, char16_t, char32_t, size_t en mbstate_t. Bij conversies staan de eerste drie typen respectievelijk voor code-eenheden van UTF-8, UTF-16 en UTF-32. Een code-eenheid komt niet altijd overeen met een volledig teken.

De paren mbrtoc8/c8rtomb, mbrtoc16/c16rtomb en mbrtoc32/c32rtomb converteren tussen de multibytecodering van de huidige LC_CTYPE-instelling en het bijbehorende UTF-formaat. De codering die bij het compileren voor gewone literals wordt gekozen, bepaalt niet welke multibytecodering deze functies gebruiken. Ga er niet van uit dat de huidige multibytecodering UTF-8 is; bewaar de toestand van mbstate_t tussen samenhangende aanroepen.

Het voorbeeld telt de code-eenheden van een UTF-8-literal zonder de afsluitende nul, ongeacht de locale. Het roept geen van deze conversiefuncties aan. De compileroptie in de repository bevestigt niet dat de productieomgeving deze functies tijdens uitvoering ondersteunt.

Voorbeelden

#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;
}

Resultaat

2

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen