Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<uchar.h> — utilitaires Unicode

L’en-tête <uchar.h> fournit des types d’unités de code Unicode et des fonctions de conversion entre les formats UTF correspondants et l’encodage multioctet des paramètres régionaux LC_CTYPE en vigueur.

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

Syntaxe

#include <uchar.h>

<uchar.h> déclare char8_t, char16_t, char32_t, size_t et mbstate_t. Dans les conversions, les trois premiers types représentent les unités de code des formats UTF-8, UTF-16 et UTF-32, respectivement. Une unité de code ne représente pas toujours un caractère entier.

Les paires mbrtoc8/c8rtomb, mbrtoc16/c16rtomb et mbrtoc32/c32rtomb assurent les conversions entre l’encodage multioctet des paramètres régionaux LC_CTYPE en vigueur et le format UTF correspondant. L’encodage choisi à la compilation pour les littéraux ordinaires ne détermine pas l’encodage multioctet utilisé par ces fonctions. Ne partez pas du principe que l’encodage multioctet en vigueur est UTF-8 ; conservez l’état mbstate_t entre les appels associés.

L’exemple compte les unités de code d’un littéral UTF-8, sans compter l’unité nulle finale et indépendamment des paramètres régionaux. Il n’appelle aucune de ces fonctions de conversion. L’option du compilateur utilisée dans le dépôt ne confirme pas leur prise en charge dans l’environnement d’exécution en production.

Exemples

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

Résultat

2

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources