База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници