CKTIS / C++
Uživatelsky definované literály
Uživatelsky definovaný literál kombinuje číselný literál, znak nebo řetězec s vlastním sufixem. Příslušný operátor literálu převede tento zápis na hodnotu, například na objekt představující vzdálenost.
Verze: 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_suffixUživatelsky definovaný literál (user-defined literal), například 42_m, se chápe jako volání operátoru literálu nebo šablony operátoru literálu. Sufix je součástí zápisu literálu, nikoli operací nad proměnnou. Mechanismus se vztahuje na celá čísla, čísla s plovoucí desetinnou čárkou, znaky a řetězce; nemění význam vestavěných sufixů, jako je LL.
Deklarace operátoru literálu (literal operator declaration) používá název, například operator""_m. Funkce patří do jmenného prostoru, včetně globálního jmenného prostoru, a její deklarace musí být dostupná při vyhledávání názvů v místě použití. Vlastní sufixy začínejte znakem _ a vyhněte se __: sufixy bez počátečního _ jsou vyhrazeny pro budoucí standardizaci, zatímco ty, které obsahují __, jsou vyhrazeny implementacím.
Číselná forma přijímající hodnotu vyžaduje unsigned long long pro celočíselný literál nebo long double pro literál s plovoucí desetinnou čárkou, nikoli int ani double. Surová číselná forma přijímá const char*; existují také šablony operátorů. Běžná řetězcová forma přijímá ukazatel a délku std::size_t, která nezahrnuje koncovou nulu, zatímco znaková forma přijímá odpovídající znakový typ.
V příkladu 42_m volá operator""_m(42ULL) a vytváří objekt Distance. constexpr umožňuje kontrolu pomocí static_assert; samotný sufix nezaručuje vyhodnocení při kompilaci. Příklad je určen k ověření v režimu C++23. Dodaný dokument je průběžně vyvíjený pracovní návrh, nikoli konečné vydání C++23.
Příklady
#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";
}
Výsledek
42 m
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.