CKTIS / C++
std::to_underlying — преобразуване на изброен тип към неговия базов тип
std::to_underlying от <utility> преобразува стойност на изброен тип към точния ѝ базов тип. Налична от C++23, функцията е constexpr и noexcept; не налага типа int и не проверява дали стойността съответства на именуван елемент от изброяването.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <utility>
template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;std::to_underlying(value) от <utility> връща числовото представяне на стойност на изброен тип. Типът на връщане е std::underlying_type_t<T>, където T е типът на аргумента. Функцията работи както с enum, така и с enum class; тя не е обща функция за преобразуване на произволни аргументи в цели числа.
Резултатът е дефиниран като static_cast<std::underlying_type_t<T>>(value). За разлика от static_cast<int>(value), функцията запазва точния базов тип, включително знаковостта му, вместо да налага int. Това е полезно, когато числовото представяне на изброен тип се подава към друг интерфейс.
Функцията е constexpr и затова може да участва в константно изчисление, а също е noexcept и не хвърля изключения. Тя не проверява дали подадената стойност съответства на именуван елемент от изброяването. Не извършва и обратното преобразуване от число към изброен тип.
В примера Status има изрично зададен базов тип unsigned int. Проверочните изрази удостоверяват типа на връщане, стойността 7u и свойството noexcept, а програмата отпечатва 7. Необходима е поддръжка на C++23 както от компилатора, така и от стандартната библиотека; само флаг за компилатора в хранилището не доказва работа в производствена среда за изпълнение.
Примери
#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';
}
Резултат
7
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.