WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

Literaloperatoren in C++ deklarieren

Deklariere eigene Suffixe `_KiB`, `_MiB` und `_pct`. Erfahre, wie die Literalform den Operator bestimmt und warum `ULL` und das unäre Minus anders funktionieren.

Version: ISO C++23; implementation support may vary

Syntax

namespace units {
    constexpr unsigned long long operator ""_KiB(unsigned long long n);
    constexpr unsigned long long operator ""_MiB(unsigned long long n);
    constexpr long double operator ""_pct(long double n);
}

// In the scope that uses the literals:
using units::operator ""_KiB;
using units::operator ""_MiB;
using units::operator ""_pct;
// Example expressions: 2_KiB, 1_MiB, -25.0_pct

Eine Deklaration wie constexpr unsigned long long operator ""_KiB(unsigned long long n); deklariert die Funktion, die 2_KiB aufruft. Deklariere sie im Namensraumbereich und schreibe das Suffix ohne Leerzeichen direkt hinter die Zahl. Die Namenssuche ist unqualifiziert: using units::operator ""_KiB; macht die Deklaration am Verwendungsort verfügbar. _KiB, _MiB und _pct sind eigene Suffixe, keine Suffixe der Standardbibliothek. Beginne eigene Suffixe mit _ und vermeide darin __.

Ein numerischer Literaloperator der Form cooked erhält den Wert, nicht die Schreibweise aus dem Quelltext. Ganzzahlige Formen bevorzugen einen Parameter vom Typ unsigned long long: 2_KiB wird als operator ""_KiB(2ULL) behandelt. ULL ist ein eingebautes Ganzzahlsuffix, das nicht überladen werden kann; kombiniere es nicht mit _KiB. Gleitkommaformen bevorzugen long double: 25.0_pct wird als operator ""_pct(25.0L) behandelt.

Ohne passende cooked-Überladung muss die Namenssuche genau eine von zwei Ausweichformen finden: einen raw-Operator mit const char* oder eine numerische Literaloperatorvorlage mit template<char...>-Parameterpaket. Beide erhalten die Schreibweise statt des Zahlenwerts. Gibt es nur die Überladung mit long double, ist 25_pct nicht wohlgeformt: Es ist ganzzahlig geschrieben und weicht nicht durch Konvertierung auf die Gleitkommaüberladung aus.

Bei -25.0_pct steht das Minus außerhalb des Literals: Es wirkt auf den Rückgabewert, nicht auf das Argument. Bei -2_KiB bleibt das Ergebnis unsigned long long und folgt der Moduloarithmetik, statt eine negative Bytezahl zu ergeben. Prüfe bei Größenberechnungen vor der Multiplikation n <= max / factor, wobei max der Höchstwert des Ergebnistyps ist; das Beispiel lässt diese Prüfung aus. Die Funktionen geben Zahlen als Werte zurück. constexpr erlaubt die Auswertung zur Übersetzungszeit, erzwingt sie aber nicht bei jedem Aufruf. Benutzerdefinierte Literale gibt es seit C++11; hier gilt C++23, und die Unterstützung kann je nach Implementierung variieren.

Beispiele

#include <iomanip>
#include <iostream>

namespace units {
constexpr unsigned long long operator ""_KiB(unsigned long long n) {
    return n * 1024ULL;
}

constexpr unsigned long long operator ""_MiB(unsigned long long n) {
    return n * 1048576ULL;
}

constexpr long double operator ""_pct(long double n) {
    return n / 100.0L;
}
}

int main() {
    using units::operator ""_KiB;
    using units::operator ""_MiB;
    using units::operator ""_pct;

    static_assert(2_KiB == 2048ULL);
    static_assert(1_MiB == 1048576ULL);
    static_assert(-25.0_pct < 0.0L);

    std::cout << 2_KiB << '\n'
              << 1_MiB << '\n'
              << std::fixed << std::setprecision(2) << -25.0_pct << '\n';
}

Ergebnis

2048
1048576
-0.25

Das Programm gibt die Bytezahlen für `2_KiB` und `1_MiB` aus, anschließend `-25.0_pct` als Bruchwert mit zwei Nachkommastellen.

Zugehörige Lektionen

  • C++ · Lektion 60 · Fortgeschritten · Version: 3

Quellen