CKTIS / C++
Door de gebruiker gedefinieerde literals
Een door de gebruiker gedefinieerde literal combineert een numerieke literal, tekenliteral of tekenreeks met een aangepast achtervoegsel. De bijbehorende literaloperator zet die schrijfwijze om in een waarde, bijvoorbeeld een object dat een afstand voorstelt.
Versie: 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_suffixEen door de gebruiker gedefinieerde literal (user-defined literal), zoals 42_m, wordt behandeld als een aanroep van een literaloperator of een literaloperatortemplate. Het achtervoegsel hoort bij de schrijfwijze van de literal; het is geen bewerking op een variabele. Dit mechanisme geldt voor gehele getallen, drijvende-kommagetallen, tekens en tekenreeksen; het verandert de betekenis van ingebouwde achtervoegsels zoals LL niet.
Een declaratie van een literaloperator (literal operator declaration) gebruikt een naam zoals operator""_m. De functie hoort bij een namespace, waaronder de globale namespace, en de declaratie moet bij de naamopzoeking op de gebruikslocatie beschikbaar zijn. Begin aangepaste achtervoegsels met _ en vermijd __: achtervoegsels zonder een vooraanstaande _ zijn gereserveerd voor toekomstige standaardisatie, terwijl achtervoegsels met __ zijn gereserveerd voor implementaties.
De numerieke vorm die een waarde ontvangt, vereist unsigned long long voor een integerliteral of long double voor een literal met drijvende komma, niet int of double. De ruwe numerieke vorm accepteert const char*; er bestaan ook operator-templates. De gewone tekenreeks vorm neemt een pointer en een std::size_t-lengte zonder de afsluitende nul in ontvangst, terwijl de tekenvorm het overeenkomstige tekentype gebruikt.
In het voorbeeld roept 42_m operator""_m(42ULL) aan en maakt een Distance aan. constexpr maakt controle met static_assert mogelijk; het achtervoegsel alleen garandeert geen evaluatie tijdens het compileren. Het voorbeeld is bedoeld voor verificatie in de C++23-modus. Het meegeleverde document is een voortdurend bijgewerkt werkconcept, geen definitieve C++23-editie.
Voorbeelden
#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";
}
Resultaat
42 m
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.