CKTIS / C++
std::to_underlying — convertire un’enumerazione nel suo tipo sottostante
std::to_underlying, dichiarata in <utility>, converte un valore di enumerazione nel suo tipo sottostante esatto. Disponibile da C++23, è constexpr e noexcept; non impone il tipo int e non verifica che il valore corrisponda a un enumeratore con nome.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <utility>
template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;std::to_underlying(value), dichiarata in <utility>, restituisce la rappresentazione numerica di un valore di enumerazione. Il tipo restituito è std::underlying_type_t<T>, dove T è il tipo dell’argomento. Funziona sia con enum sia con enum class; non è una funzione generica per convertire argomenti arbitrari in interi.
Il risultato è definito come static_cast<std::underlying_type_t<T>>(value). A differenza di static_cast<int>(value), la funzione mantiene il tipo sottostante esatto, compreso il fatto che sia con segno o senza segno, invece di imporre int. È utile quando si passa la rappresentazione numerica di un’enumerazione a un’altra interfaccia.
La funzione è constexpr, quindi può partecipare alla valutazione costante, ed è noexcept, quindi non genera eccezioni. Non controlla se il valore fornito corrisponde a un enumeratore con nome. Inoltre non esegue la conversione inversa, da un numero a un’enumerazione.
Nell’esempio, Status ha il tipo sottostante esplicito unsigned int. Le asserzioni verificano il tipo restituito, il valore 7u e la proprietà noexcept, mentre il programma stampa 7. È necessario che C++23 sia supportato sia dal compilatore sia dalla libreria standard; la sola presenza di un’opzione del compilatore nel repository non dimostra il funzionamento in un ambiente di esecuzione di produzione.
Esempi
#include <iostream>
#include <type_traits>
#include <utility>
enum class Status : unsigned int {
ready = 7,
done = 9
};
static_assert(std::is_same_v<
decltype(std::to_underlying(Status::ready)), unsigned int>);
static_assert(std::to_underlying(Status::ready) == 7u);
static_assert(noexcept(std::to_underlying(Status::ready)));
int main() {
std::cout << std::to_underlying(Status::ready) << '\n';
}
Risultato
7
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.