Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Literały zdefiniowane przez użytkownika

Literał zdefiniowany przez użytkownika łączy zapis liczby, znaku lub napisu z własnym sufiksem. Odpowiadający mu operator literałowy przekształca ten zapis w wartość, na przykład obiekt reprezentujący odległość.

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

Składnia

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

Literał zdefiniowany przez użytkownika (user-defined literal), np. 42_m, jest traktowany jako wywołanie operatora literałowego lub jego szablonu. Sufiks jest częścią zapisu literału, a nie operacją na zmiennej. Mechanizm obejmuje liczby całkowite, liczby zmiennoprzecinkowe, znaki i napisy; nie zmienia znaczenia wbudowanych sufiksów takich jak LL.

Deklaracja operatora literałowego (literal operator declaration) używa nazwy takiej jak operator""_m. Funkcja należy do przestrzeni nazw, także globalnej, a jej deklaracja musi być dostępna podczas wyszukiwania nazwy w miejscu użycia. Dla własnych sufiksów wybieraj początkowe _ i unikaj __: sufiksy bez początkowego _ są zarezerwowane dla przyszłej standaryzacji, a zawierające __ — dla implementacji.

Postać przyjmująca wartość liczbową wymaga unsigned long long dla literału całkowitego albo long double dla zmiennoprzecinkowego, nie int ani double. Surowa postać liczbowa przyjmuje const char*; istnieją też szablony operatorów. Zwykła postać napisowa przyjmuje wskaźnik i std::size_t oznaczające długość bez końcowego zera, a znakowa — odpowiedni typ znaku.

W przykładzie 42_m wywołuje operator""_m(42ULL) i tworzy Distance. constexpr umożliwia sprawdzenie przez static_assert; sam sufiks nie gwarantuje obliczenia podczas kompilacji. Przykład jest przeznaczony do weryfikacji w trybie C++23. Podany dokument jest rozwijanym szkicem, nie zamrożonym wydaniem C++23.

Przykłady

#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";
}

Wynik

42 m

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła