Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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_suffix

Un 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.

Fonti