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)
Definido en el encabezado <type_traits>
template < class T >
struct underlying_type ;
(desde C++11)

Si T es un tipo de enumeración (enum) completo, proporciona un typedef miembro type que nombra el tipo subyacente de T .

De lo contrario, el comportamiento es indefinido.

(until C++20)

De lo contrario, si T no es un tipo de enumeración, no existe el miembro type . De lo contrario ( T es un tipo de enumeración incompleto), el programa está mal formado.

(since C++20)

Si el programa añade especializaciones para std::underlying_type , el comportamiento no está definido.

Contenidos

Tipos de miembros

Nombre Definición
type el tipo subyacente de T

Tipos auxiliares

template < class T >
using underlying_type_t = typename underlying_type < T > :: type ;
(desde C++14)

Notas

Cada tipo de enumeración tiene un tipo subyacente , que puede ser

  1. Especificado explícitamente (tanto enumeraciones con ámbito como sin ámbito);
  2. Omitido, en cuyo caso es int para enumeraciones con ámbito o un tipo integral definido por la implementación capaz de representar todos los valores del enum (para enumeraciones sin ámbito).

Ejemplo

Ejecutar este código 
#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';
}

Salida posible: 

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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 2396 C++11 se permitían tipos de enumeración incompletos se requiere tipo de enumeración completo

Véase también

(C++11)
comprueba si un tipo es un tipo de enumeración
(class template)
(C++23)
comprueba si un tipo es un tipo de enumeración con ámbito
(class template)
(C++23)
convierte una enumeración a su tipo subyacente
(function template)