Namespaces
Variants

std:: underlying_type

From cppreference.net
C++
Metaprogramming library
Type traits
Type categories
(C++11)
(C++11) ( DR* )
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Type properties
(C++11)
(C++11)
(C++11)
(C++11)
(C++14)
(C++11)
(C++17)
(C++23)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
(C++11) ( until C++20* )
(C++11) (deprecated in C++20)
(C++11)
(C++11)
(C++20)
(C++20)
(C++23)
(C++17)
Type trait constants
(C++11) (C++17) (C++11) (C++11)
Metafunctions
(C++17)
(C++17)
(C++17)
Supported operations
Relationships and property queries
Type modifications
Type transformations
(C++11) (deprecated in C++23)
(C++11) (deprecated in C++23)
(C++11)
(C++20)
(C++11) ( until C++20* ) (C++17)

(C++11)
(C++11)
(C++20)
underlying_type
(C++11)
(C++20)
(C++11)
(C++17)
Compile-time rational arithmetic
Compile-time integer sequences
(C++14)
Определено в заголовочном файле <type_traits>
template < class T >
struct underlying_type ;
(начиная с C++11)

Если T является полным перечислимым типом (enum), предоставляет член-typedef type , который обозначает базовый тип T .

В противном случае поведение не определено.

(до C++20)

В противном случае, если T не является типом перечисления, член type отсутствует. В противном случае ( T является неполным типом перечисления), программа является некорректной.

(начиная с C++20)

Если программа добавляет специализации для std::underlying_type , поведение не определено.

Содержание

Типы членов

Название Определение
type базовый тип T

Вспомогательные типы

template < class T >
using underlying_type_t = typename underlying_type < T > :: type ;
(начиная с C++14)

Примечания

Каждый тип перечисления имеет базовый тип , которым может быть

  1. Указан явно (как для ограниченных, так и для неограниченных перечислений);
  2. Опущен, в этом случае используется int для ограниченных перечислений или определяемый реализацией целочисленный тип, способный представлять все значения перечисления (для неограниченных перечислений).

Пример

Запустить этот код 
#include <iostream>
#include <type_traits>
enum e1 {};
enum class e2 {};
enum class e3 : unsigned {};
enum class e4 : int {};
int main()
{
    constexpr bool e1_t = std::is_same_v<std::underlying_type_t<e1>, int>;
    constexpr bool e2_t = std::is_same_v<std::underlying_type_t<e2>, int>;
    constexpr bool e3_t = std::is_same_v<std::underlying_type_t<e3>, int>;
    constexpr bool e4_t = std::is_same_v<std::underlying_type_t<e4>, int>;
    std::cout
        << "underlying type for 'e1' is " << (e1_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e2' is " << (e2_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e3' is " << (e3_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e4' is " << (e4_t ? "int" : "non-int") << '\n';
}

Возможный вывод: 

underlying type for 'e1' is non-int
underlying type for 'e2' is int
underlying type for 'e3' is non-int
underlying type for 'e4' is int

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
LWG 2396 C++11 incomplete enumeration types were allowed complete enumeration type required

Смотрите также

(C++11)
проверяет, является ли тип перечислением
(шаблон класса)
(C++23)
проверяет, является ли тип scoped-перечислением
(шаблон класса)
(C++23)
преобразует перечисление в его базовый тип
(шаблон функции)