CKTIS / C++
Benutzerdefinierte Literale
Ein benutzerdefiniertes Literal verbindet ein Zahlen-, Zeichen- oder Zeichenkettenliteral mit einem eigenen Suffix. Der zugehörige Literaloperator wandelt diese Schreibweise in einen Wert um, zum Beispiel in ein Objekt, das eine Entfernung darstellt.
Version: 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_suffixEin benutzerdefiniertes Literal (user-defined literal) wie 42_m wird als Aufruf eines Literaloperators oder eines Literaloperator-Templates behandelt. Das Suffix ist Teil der Schreibweise des Literals und keine Operation auf einer Variablen. Der Mechanismus gilt für Ganzzahlen, Gleitkommazahlen, Zeichen und Zeichenketten; die Bedeutung eingebauter Suffixe wie LL wird dadurch nicht geändert.
Eine Deklaration eines Literaloperators (literal operator declaration) verwendet einen Namen wie operator""_m. Die Funktion gehört zu einem Namespace, auch zum globalen Namespace, und ihre Deklaration muss bei der Namenssuche am Verwendungsort verfügbar sein. Beginne eigene Suffixe mit _ und vermeide __: Suffixe ohne anfängliches _ sind für eine künftige Standardisierung reserviert, während solche mit __ Implementierungen vorbehalten sind.
Die numerische Form, die einen Wert entgegennimmt, erfordert unsigned long long für ein Ganzzahlliteral oder long double für ein Gleitkommaliteral, nicht int oder double. Die rohe numerische Form akzeptiert const char*; außerdem gibt es Operator-Templates. Die gewöhnliche Zeichenkettenform nimmt einen Zeiger und eine std::size_t-Länge ohne abschließendes Nullzeichen entgegen, während die Zeichenform den entsprechenden Zeichentyp verwendet.
Im Beispiel ruft 42_m operator""_m(42ULL) auf und erstellt ein Distance-Objekt. constexpr ermöglicht die Prüfung mit static_assert; das Suffix allein garantiert keine Auswertung zur Compilezeit. Das Beispiel ist für die Überprüfung im C++23-Modus vorgesehen. Das bereitgestellte Dokument ist ein fortlaufend bearbeiteter Arbeitsentwurf und keine endgültige C++23-Ausgabe.
Beispiele
#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";
}
Ergebnis
42 m
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.