std::underlying_type

工具库

语言支持
类型支持（基本类型、 RTTI 、类型特征）
库功能特性测试宏 (C++20)
动态内存管理
程序工具
错误处理
协程支持 (C++20)
变参数函数
launder (C++17)
initializer_list (C++11)
source_location (C++20)
三路比较 (C++20)
three_way_comparablethree_way_comparable_with (C++20)(C++20)
strong_ordering (C++20)
weak_ordering (C++20)
partial_ordering (C++20)
common_comparison_category (C++20)
compare_three_way_result (C++20)
compare_three_way (C++20)
strong_order (C++20)
weak_order (C++20)
partial_order (C++20)
compare_strong_order_fallback (C++20)
compare_weak_order_fallback (C++20)
compare_partial_order_fallback (C++20)
is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

通用工具

日期和时间

格式化库 (C++20)

(C++11)

(C++14)

关系运算符 (C++20 中弃用)

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

整数比较函数

cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than

(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

in_range

(C++20)

swap 与类型运算

swap
ranges::swap (C++20)
exchange (C++14)
declval (C++11)

forward (C++11)
move (C++11)
move_if_noexcept (C++11)
as_const (C++17)

常用词汇类型

pair
tuple (C++11)
apply (C++17)
make_from_tuple (C++17)

optional (C++17)
any (C++17)
variant (C++17)

初等字符串转换

to_chars

(C++17)

from_chars

(C++17)

chars_format

(C++17)

栈踪

stacktrace_entry

(C++23)

basic_stacktrace

(C++23)

定义于头文件 `<type_traits>`
template< class T > struct underlying_type;		(C++11 起)

若 T 是完整枚举类型，则提供指名 T 底层类型的成员 typedef type 。

否则，行为未定义。	(C++20 前)
否则，若 `T` 不是枚举类型，则无成员 `type` 。否则（ `T` 为不完整枚举类型）程序为谬构。	(C++20 起)

添加 underlying_type 的特化的程序行为未定义。

成员类型


名称	定义
`type`	`T` 的底层类型

辅助类型

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

注解

每个枚举类型都拥有底层类型，它可以是

1. 显式指定（有作用域和无作用域枚举均可）

2. 省略，该情况下对于有作用域枚举是 int ，或（对于无作用域枚举）是足以表示枚举所有值的实现定义的整数类型

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR	应用于	出版时的行为	正确行为
LWG 2396	C++11	允许不完整枚举类型	要求完整枚举类型

示例

运行此代码

#include <iostream>
#include <type_traits>
 
enum e1 {};
enum class e2: int {};
 
int main() {
    bool e1_type = std::is_same<
        unsigned
       ,typename std::underlying_type<e1>::type
    >::value; 
 
    bool e2_type = std::is_same<
        int
       ,typename std::underlying_type<e2>::type
    >::value;
 
    std::cout
    << "underlying type for 'e1' is " << (e1_type?"unsigned":"non-unsigned") << '\n'
    << "underlying type for 'e2' is " << (e2_type?"int":"non-int") << '\n';
}

输出：

underlying type for 'e1' is unsigned
underlying type for 'e2' is int

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
技术规范