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_suffixLiterał 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.