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

CKTIS / C++

char16_t — type d’unité de code UTF-16

char16_t est un type entier intégré destiné à stocker des unités de code UTF-16. Une valeur ne représente pas nécessairement un caractère Unicode complet : certains points de code nécessitent une paire d’unités de code.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

char16_t unit = u'A';
const char16_t text[] = u"A\U0001F600";

char16_t est un type caractère et entier intégré distinct. Son type sous-jacent est std::uint_least16_t, mais il n’en est pas un alias. Il fournit au moins 16 bits de valeur ; ne supposez pas que sizeof(char16_t) == 2. L’utilisation du mot-clé lui-même ne nécessite aucun en-tête.

Le préfixe u crée des littéraux UTF-16 : u'A' est de type char16_t, tandis que u"A" est un tableau à terminaison nulle d’éléments const char16_t. Un caractère écrit dans un littéral caractère doit tenir dans une unité de code UTF-16. Ainsi, u'\U0001F600' est incorrect, alors que u"\U0001F600" est un littéral chaîne valide.

Une unité de code n’est pas la même chose qu’un point de code ni qu’un caractère perçu par l’utilisateur. En UTF-16, les points de code en dehors du plan multilingue de base nécessitent une paire de substituts. Le type char16_t ne valide pas lui-même l’UTF-16 : un tableau peut aussi contenir des substituts isolés.

L’exemple stocke A et U+1F600 : trois unités de code plus un zéro final, soit quatre éléments de tableau. La division par sizeof(text[0]) compte les éléments sans supposer une taille d’octet particulière. La sortie présentée a été obtenue dans l’environnement où l’exemple a été exécuté et n’est pas garantie sur toutes les implémentations. Si std::size_t est un alias de unsigned char, count est promu en int ou en unsigned int dans count - 1, et le résultat de la soustraction est affiché sous forme numérique. Si, en revanche, std::size_t est un type entier étendu non signé de rang supérieur à int, count ne fait pas l’objet d’une promotion, et le choix de la surcharge de << pour le résultat peut être ambigu. La seconde instruction insère directement count dans le flux avec son type std::size_t. Si std::size_t est un alias de unsigned char, cette insertion écrit un caractère au lieu du chiffre 4. Aucune des deux instructions n’affiche le texte UTF-16 stocké dans text. Cette entrée concerne C++23 ; le site fourni héberge un projet de norme en évolution, et non une publication C++23 figée.

Exemples

#include <iostream>

int main() {
    constexpr char16_t unit = u'A';
    constexpr char16_t text[] = u"A\U0001F600";
    constexpr auto count = sizeof(text) / sizeof(text[0]);

    static_assert(unit == 0x0041);
    static_assert(count == 4);
    static_assert(text[1] == 0xD83D && text[2] == 0xDE00);
    static_assert(text[3] == 0);

    std::cout << "code units: " << count - 1 << '\n';
    std::cout << "array elements: " << count << '\n';
}

Résultat

code units: 3
array elements: 4

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