Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła