CKTIS / C++
Uporabniško določeni literali
Uporabniško določeni literal združuje številski literal, znak ali niz z lastno pripono. Ustrezni operator za literale ta zapis pretvori v vrednost, na primer v objekt, ki predstavlja razdaljo.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
constexpr ReturnType operator""_suffix(unsigned long long value);
constexpr ReturnType operator""_suffix(long double value);
123_suffix
1.5_suffixUporabniško določeni literal (user-defined literal), na primer 42_m, se obravnava kot klic operatorja za literale ali predloge operatorja za literale. Pripona je del zapisa literala, ne operacija nad spremenljivko. Mehanizem zajema cela števila, števila s plavajočo vejico, znake in nize; ne spremeni pomena vgrajenih pripon, kot je LL.
Deklaracija operatorja za literale (literal operator declaration) uporablja ime, kot je operator""_m. Funkcija pripada imenskemu prostoru, tudi globalnemu, njena deklaracija pa mora biti na voljo pri iskanju imen na mestu uporabe. Lastne pripone začnite z _ in se izogibajte __: pripone brez začetnega _ so rezervirane za prihodnjo standardizacijo, tiste, ki vsebujejo __, pa za implementacije.
Številska oblika, ki sprejme vrednost, zahteva unsigned long long za celoštevilski literal ali long double za literal s plavajočo vejico, ne pa int ali double. Surova številska oblika sprejme const char*; obstajajo tudi predloge operatorjev. Običajna oblika za nize sprejme kazalec in dolžino std::size_t, ki ne vključuje zaključne ničle, znakovna oblika pa sprejme ustrezni znakovni tip.
V primeru 42_m pokliče operator""_m(42ULL) in ustvari objekt Distance. constexpr omogoča preverjanje z static_assert; sama pripona ne zagotavlja vrednotenja med prevajanjem. Primer je namenjen preverjanju v načinu C++23. Priloženi dokument je sproti razvijani delovni osnutek, ne dokončna izdaja C++23.
Primeri
#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";
}
Rezultat
42 m
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.