Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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_suffix

Už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.

Zdroje