CKTIS / C++
Letterali definiti dall’utente
Un letterale definito dall’utente combina un letterale numerico, carattere o stringa con un suffisso personalizzato. Il corrispondente operatore letterale trasforma la scrittura in un valore, per esempio un oggetto che rappresenta una distanza.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
constexpr ReturnType operator""_suffix(unsigned long long value);
constexpr ReturnType operator""_suffix(long double value);
123_suffix
1.5_suffixUn letterale definito dall’utente (user-defined literal), come 42_m, viene trattato come una chiamata a un operatore letterale o a un modello di operatore letterale. Il suffisso fa parte della scrittura del letterale; non è un’operazione su una variabile. Il meccanismo riguarda interi, numeri in virgola mobile, caratteri e stringhe; non modifica il significato dei suffissi integrati come LL.
Una dichiarazione di operatore letterale (literal operator declaration) usa un nome come operator""_m. La funzione appartiene a uno spazio dei nomi, compreso quello globale, e la sua dichiarazione deve essere disponibile alla ricerca dei nomi nel punto di utilizzo. Inizia i suffissi personalizzati con _ ed evita __: i suffissi senza _ iniziale sono riservati a una futura standardizzazione, mentre quelli che contengono __ sono riservati alle implementazioni.
La forma numerica che riceve un valore richiede unsigned long long per un letterale intero o long double per un letterale in virgola mobile, non int o double. La forma numerica grezza accetta const char*; esistono anche modelli di operatore. La forma ordinaria per le stringhe riceve un puntatore e una lunghezza std::size_t che esclude il terminatore nullo, mentre la forma per i caratteri riceve il tipo di carattere corrispondente.
Nell’esempio, 42_m chiama operator""_m(42ULL) e costruisce un Distance. constexpr consente la verifica con static_assert; il suffisso da solo non garantisce la valutazione in fase di compilazione. L’esempio è pensato per la verifica in modalità C++23. Il documento fornito è una bozza di lavoro in evoluzione, non un’edizione definitiva di C++23.
Esempi
#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";
}
Risultato
42 m
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.