CKTIS / C++
std::to_underlying — konwersja wyliczenia na typ bazowy
std::to_underlying z nagłówka <utility> przekształca wartość wyliczenia na jego dokładny typ bazowy. Funkcja dostępna od C++23 jest constexpr i noexcept; nie narzuca typu int ani nie sprawdza, czy wartość odpowiada nazwanemu elementowi wyliczenia.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <utility>
template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;std::to_underlying(value) z nagłówka <utility> zwraca liczbową reprezentację wartości wyliczenia. Typ wyniku to std::underlying_type_t<T>, gdzie T jest typem argumentu. Funkcja działa zarówno dla enum, jak i enum class; nie jest ogólną funkcją konwertującą dowolny argument na liczbę całkowitą.
Wynik jest zdefiniowany jako static_cast<std::underlying_type_t<T>>(value). W przeciwieństwie do static_cast<int>(value) funkcja zachowuje dokładny typ bazowy, w tym jego znakowość, zamiast narzucać int. Jest to przydatne przy przekazywaniu liczbowej reprezentacji wyliczenia do innego interfejsu.
Funkcja jest constexpr, więc może uczestniczyć w obliczeniach stałych, oraz noexcept, więc nie zgłasza wyjątków. Nie sprawdza, czy przekazana wartość odpowiada nazwanemu elementowi wyliczenia. Nie wykonuje też konwersji odwrotnej: z liczby na wyliczenie.
W przykładzie Status ma jawny typ bazowy unsigned int. Asercje sprawdzają typ wyniku, wartość 7u i właściwość noexcept, a program wypisuje 7. Wymagana jest obsługa C++23 przez kompilator i bibliotekę standardową; sama flaga kompilatora w repozytorium nie potwierdza działania w środowisku produkcyjnym.
Przykłady
#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';
}
Wynik
7
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.