CKTIS / C++
Používateľom definované literály
Používateľom definovaný literál kombinuje číselný literál, znak alebo reťazec s vlastným sufixom. Príslušný operátor literálu prevedie tento zápis na hodnotu, napríklad na objekt predstavujúci vzdialenosť.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
constexpr ReturnType operator""_suffix(unsigned long long value);
constexpr ReturnType operator""_suffix(long double value);
123_suffix
1.5_suffixPoužívateľom definovaný literál (user-defined literal), napríklad 42_m, sa chápe ako volanie operátora literálu alebo šablóny operátora literálu. Sufix je súčasťou zápisu literálu, nie operáciou nad premennou. Mechanizmus sa vzťahuje na celé čísla, čísla s pohyblivou desatinnou čiarkou, znaky a reťazce; nemení význam vstavaných sufixov, ako je LL.
Deklarácia operátora literálu (literal operator declaration) používa názov, napríklad operator""_m. Funkcia patrí do menného priestoru vrátane globálneho menného priestoru a jej deklarácia musí byť dostupná pri vyhľadávaní názvov na mieste použitia. Vlastné sufixy začínajte znakom _ a vyhnite sa __: sufixy bez úvodného _ sú vyhradené na budúcu štandardizáciu, zatiaľ čo tie, ktoré obsahujú __, sú vyhradené pre implementácie.
Číselná forma prijímajúca hodnotu vyžaduje unsigned long long pre celočíselný literál alebo long double pre literál s pohyblivou desatinnou čiarkou, nie int ani double. Surová číselná forma prijíma const char*; existujú aj šablóny operátorov. Bežná reťazcová forma prijíma ukazovateľ a dĺžku std::size_t, ktorá nezahŕňa koncovú nulu, zatiaľ čo znaková forma prijíma príslušný znakový typ.
V príklade 42_m volá operator""_m(42ULL) a vytvára objekt Distance. constexpr umožňuje kontrolu pomocou static_assert; samotný sufix nezaručuje vyhodnotenie počas kompilácie. Príklad je určený na overenie v režime C++23. Dodaný dokument je priebežne vyvíjaný pracovný návrh, nie konečné vydanie C++23.
Prí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ýsledok
42 m
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.