std::underlying_type
来自 cppreference.com
定义在头文件 <type_traits> 中 |
||
template< class T > struct underlying_type; |
(自 C++11 起) | |
如果 T
是一个完整的枚举(enum)类型,则提供一个名为 type
的成员类型定义,它指定了 T
的底层类型。
否则,行为未定义。 |
(直到 C++20) |
否则,如果 |
(自 C++20 起) |
如果程序为 std::underlying_type
添加了专门化,则行为未定义。
内容 |
[编辑] 成员类型
名称 | 定义 |
type
|
T 的底层类型 |
[编辑] 辅助类型
template< class T > using underlying_type_t = typename underlying_type<T>::type; |
(自 C++14 起) | |
[编辑] 备注
每个 枚举类型 都有一个底层类型,它可以是
- 显式指定(作用域和非作用域枚举);
- 省略,在这种情况下,作用域枚举为 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 | 应用于 | 已发布的行为 | 正确行为 |
---|---|---|---|
LWG 2396 | C++11 | 允许不完整的枚举类型 | 需要完整的枚举类型 |
[编辑] 另请参阅
(C++11) |
检查类型是否为枚举类型 (类模板) |
(C++23) |
检查类型是否为作用域枚举类型 (类模板) |
(C++23) |
将枚举转换为其底层类型 (函数模板) |