Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti