Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Dichiarazione degli operatori di letterale in C++

Dichiara i suffissi personalizzati `_KiB`, `_MiB` e `_pct`. Scopri come la forma del letterale seleziona l’operatore e perché `ULL` e il meno unario sono diversi.

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

Sintassi

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

Una dichiarazione come constexpr unsigned long long operator ""_KiB(unsigned long long n); dichiara la funzione invocata da 2_KiB. Dichiarala a livello di namespace e scrivi il suffisso subito dopo il numero, senza spazi. La ricerca del nome è non qualificata: using units::operator ""_KiB; rende disponibile la dichiarazione nel punto d’uso. _KiB, _MiB e _pct sono suffissi personalizzati, non della libreria standard. Inizia i suffissi personalizzati con _ e non usare __ al loro interno.

Un operatore numerico di forma cooked riceve il valore, non la grafia nel codice sorgente. Le forme intere danno la precedenza a un parametro unsigned long long: 2_KiB è trattato come operator ""_KiB(2ULL). ULL è un suffisso intero predefinito e non sovraccaricabile; non combinarlo con _KiB. Le forme in virgola mobile danno la precedenza a long double: 25.0_pct è trattato come operator ""_pct(25.0L).

In assenza del sovraccarico cooked corrispondente, la ricerca deve trovare esattamente una tra due forme alternative: un operatore raw con const char* o un template di operatore di letterale numerico con un pacchetto template<char...>. Entrambi ricevono la grafia del sorgente, non il valore numerico. Se è presente solo il sovraccarico long double, 25_pct non è ben formato: ha forma intera e non passa al sovraccarico in virgola mobile tramite conversione.

In -25.0_pct il meno è esterno al letterale: agisce sul valore restituito, non sull’argomento. In -2_KiB il risultato rimane unsigned long long e segue l’aritmetica modulare invece di diventare un numero negativo di byte. Per calcolare dimensioni, verifica n <= max / factor prima di moltiplicare, dove max è il massimo del tipo del risultato; l’esempio omette il controllo. Le funzioni restituiscono numeri per valore e constexpr permette la valutazione in fase di compilazione senza imporla a ogni chiamata. I letterali definiti dall’utente esistono da C++11; questa scheda descrive C++23 e il supporto può variare tra implementazioni.

Esempi

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

Risultato

2048
1048576
-0.25

Il programma stampa il numero di byte per `2_KiB` e `1_MiB`, quindi `-25.0_pct` come frazione con due cifre decimali.

Lezioni correlate

  • C++ · Lezione 60 · Avanzato · Versione: 3

Fonti