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

CKTIS / C++

Littéraux définis par l’utilisateur

Un littéral défini par l’utilisateur associe un littéral numérique, caractère ou chaîne à un suffixe personnalisé. L’opérateur littéral correspondant transforme cette écriture en une valeur, par exemple un objet représentant une distance.

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

Syntaxe

constexpr ReturnType operator""_suffix(unsigned long long value);
constexpr ReturnType operator""_suffix(long double value);
123_suffix
1.5_suffix

Un littéral défini par l’utilisateur (user-defined literal), tel que 42_m, est traité comme un appel à un opérateur littéral ou à un modèle d’opérateur littéral. Le suffixe fait partie de l’écriture du littéral ; ce n’est pas une opération sur une variable. Le mécanisme concerne les entiers, les nombres à virgule flottante, les caractères et les chaînes ; il ne redéfinit pas les suffixes intégrés tels que LL.

Une déclaration d’opérateur littéral (literal operator declaration) utilise un nom tel que operator""_m. La fonction appartient à un espace de noms, y compris l’espace de noms global, et sa déclaration doit être accessible à la recherche de noms à l’endroit où elle est utilisée. Commencez les suffixes personnalisés par _ et évitez __ : les suffixes sans _ initial sont réservés à une future normalisation, tandis que ceux contenant __ sont réservés aux implémentations.

La forme numérique qui reçoit une valeur exige unsigned long long pour un littéral entier ou long double pour un littéral à virgule flottante, et non int ou double. La forme numérique brute accepte const char* ; il existe aussi des modèles d’opérateurs. La forme ordinaire pour les chaînes reçoit un pointeur et une longueur std::size_t excluant le zéro terminal, tandis que la forme caractère reçoit le type de caractère correspondant.

Dans l’exemple, 42_m appelle operator""_m(42ULL) et construit un Distance. constexpr permet la vérification par static_assert ; le suffixe seul ne garantit pas une évaluation à la compilation. L’exemple est destiné à être vérifié en mode C++23. Le document fourni est un brouillon de travail en évolution, et non une édition C++23 définitive.

Exemples

#include <iostream>

struct Distance {
    unsigned long long metres;
};

constexpr Distance operator""_m(unsigned long long value) {
    return Distance{value};
}

int main() {
    constexpr auto distance = 42_m;
    static_assert(distance.metres == 42);
    std::cout << distance.metres << " m\n";
}

Résultat

42 m

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