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_suffixUn 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.