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_pctUna 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