Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Deklaracja operatora literału w C++

Zadeklaruj własne sufiksy `_KiB`, `_MiB` i `_pct`. Dowiedz się, jak postać literału decyduje o wyborze operatora i dlaczego `ULL` oraz jednoargumentowy minus działają inaczej.

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

Składnia

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

Deklaracja operatora literału, np. constexpr unsigned long long operator ""_KiB(unsigned long long n);, wprowadza funkcję wywoływaną przez literał 2_KiB. Zadeklaruj ją w zakresie przestrzeni nazw i dopisz sufiks do liczby bez spacji. Wyszukiwanie nazwy operatora jest niekwalifikowane: deklaracja using units::operator ""_KiB; udostępnia ją w miejscu użycia. _KiB, _MiB i _pct to własne sufiksy, a nie sufiksy biblioteki standardowej. Własne sufiksy zaczynaj od _ i nie używaj w nich __.

Operator liczbowy typu cooked otrzymuje wartość, a nie zapis źródłowy. Dla liczb całkowitych preferowany jest parametr unsigned long long: 2_KiB odpowiada wywołaniu operator ""_KiB(2ULL). ULL to wbudowany sufiks całkowity, którego nie można przeciążyć; nie łącz go z _KiB. Dla liczb zmiennoprzecinkowych preferowany jest parametr long double: 25.0_pct odpowiada operator ""_pct(25.0L).

Jeśli nie ma odpowiedniego przeciążenia typu cooked, wyszukiwanie musi znaleźć dokładnie jedną z dwóch form awaryjnych: operator surowy z parametrem const char* albo szablon operatora liczbowego z pakietem template<char...>. Obie otrzymują zapis źródłowy, a nie obliczoną wartość. Przy samym przeciążeniu long double zapis 25_pct jest niepoprawny: ma postać całkowitą i nie przechodzi na przeciążenie zmiennoprzecinkowe przez konwersję.

W -25.0_pct minus jest poza literałem: działa na wartości zwróconej przez operator, a nie na jego argumencie. W -2_KiB wynik pozostaje typu unsigned long long i podlega arytmetyce modulo, zamiast stać się ujemną liczbą bajtów. Przed mnożeniem na potrzeby rozmiarów sprawdź, czy n <= max / factor, gdzie max to maksimum typu wyniku; przykład pomija tę kontrolę. Funkcje zwracają liczby przez wartość, a constexpr pozwala na obliczanie w czasie kompilacji, ale nie wymusza go dla każdego wywołania. Literały użytkownika są dostępne od C++11; opis dotyczy C++23, a obsługa zależy od implementacji.

Przykłady

#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';
}

Wynik

2048
1048576
-0.25

Program wypisuje liczbę bajtów dla `2_KiB` i `1_MiB`, a następnie `-25.0_pct` jako ułamek z dwiema cyframi po kropce.

Powiązane lekcje

  • C++ · Lekcja 60 · Zaawansowany · Wersja: 3

Źródła