C++ 标准库标头
< cpp
C++ 标准库的接口由下列标头的汇集定义。
概念库 |
|
|
(C++20)
|
基础库概念 |
协程库 |
|
|
(C++20)
|
协程支持库 |
工具库 |
|
|
(C++17)
|
std::any 类 |
| std::bitset 类模板 | |
|
(C++11)
|
C++ 时间工具 |
|
(C++20)
|
三路比较运算符支持 |
| 保存（及跳转）到执行环境的宏（与函数） | |
| 用于信号管理的函数与宏常量 | |
| 变长实参列表的处理 | |
| 标准宏与 typedef | |
| 通用工具：程序控制、动态内存分配、随机数、排序与搜索 | |
| C 风格日期/时间工具 | |
|
(C++26)
|
调试库 |
|
(C++23)
|
std::expected 类模板 |
| 函数对象、函数调用、绑定操作及引用包装 | |
|
(C++11)
|
std::initializer_list 类模板 |
|
(C++17)
|
std::optional 类模板 |
|
(C++20)
|
提供获得源码位置的手段 |
|
(C++11)
|
std::tuple 类模板 |
|
(C++11)
|
编译时类型信息 |
|
(C++11)
|
std::type_index |
| 运行时类型信息工具 | |
| 多种工具组件 | |
|
(C++17)
|
std::variant 类模板 |
|
(C++20)
|
提供依赖实现的库信息 |
动态内存管理 |
|
| 高层内存管理工具 | |
|
(C++17)
|
多态分配器与内存资源 |
| 低层内存管理工具 | |
|
(C++11)
|
嵌套分配器类 |
数值极限 |
|
| 浮点类型的极限 | |
|
(C++11)
|
格式化宏、 intmax_t 与 uintmax_t 数学与转换 |
| 整数类型的极限 | |
|
(C++11)
|
定宽整数类型与其他类型的极限 |
| 查询算术类型属性的一致方式 | |
|
(C++23)
|
可选的拓展浮点类型 |
错误处理 |
|
| 比较其实参与零的条件编译宏 | |
| 含有最后一次错误号的宏 | |
| 异常处理工具 | |
|
(C++23)
|
栈踪迹库 |
| 标准异常对象 | |
|
(C++11)
|
定义 std::error_code，依赖平台的错误码 |
字符串库 |
|
| 确定窄字符类别的函数 | |
|
(C++17)
|
std::to_chars 与 std::from_chars |
| 多种窄字符串处理函数 | |
|
(C++11)
|
C 风格 Unicode 字符转换函数 |
| 多种宽与多字节字符串处理函数 | |
| 确定宽字符的类别的函数 | |
|
(C++20)
|
格式化库，包含 std::format |
| std::basic_string 类模板 | |
|
(C++17)
|
std::basic_string_view 类模板 |
容器库 |
|
|
(C++11)
|
std::array 容器 |
| std::deque 容器 | |
|
(C++23)
|
std::flat_map 和 std::flat_multimap 容器适配器 |
|
(C++23)
|
std::flat_set 和 std::flat_multiset 容器适配器 |
|
(C++11)
|
std::forward_list 容器 |
|
(C++26)
|
std::inplace_vector 容器 |
| std::list 容器 | |
| std::map 与 std::multimap 关联容器 | |
|
(C++23)
|
std::mdspan 视图 |
| std::queue 与 std::priority_queue 容器适配器 | |
| std::set 与 std::multiset 关联容器 | |
|
(C++20)
|
std::span 视图 |
| std::stack 容器适配器 | |
|
(C++11)
|
std::unordered_map 与 std::unordered_multimap 无序关联容器 |
|
(C++11)
|
std::unordered_set 与 std::unordered_multiset 无序关联容器 |
| std::vector 容器 | |
迭代器库 |
|
| 范围迭代器 | |
范围库 |
|
|
(C++23)
|
std::generator 类模板 |
|
(C++20)
|
范围访问、元件、要求、工具及适配器 |
算法库 |
|
| 在范围上操作的算法 | |
|
(C++17)
|
并行版本算法的预定义执行策略 |
数值库 |
|
|
(C++20)
|
位操纵函数 |
|
(C++11)
|
浮点环境访问函数 |
| 常用数学函数 | |
| 复数类型 | |
|
(C++26)
|
基本线性代数算法 |
|
(C++20)
|
数学常数 |
| 范围中的值上的数值运算 | |
|
(C++11)
|
随机数生成器与分布 |
|
(C++11)
|
编译时有理数算术 |
| 表示和操纵值的数组的类 | |
本地化库 |
|
| C 本地化工具 | |
|
(C++11)(C++17 中弃用)(C++26 中移除)
|
Unicode 转换设施 |
| 本地化工具 | |
|
(C++26)
|
文本编码识别 |
输入/输出库 |
|
| C 风格输入输出函数 | |
| std::basic_fstream、std::basic_ifstream、std::basic_ofstream 类模板及数个 typedef | |
| 格式化输入与输出的辅助函数 | |
| std::ios_base 类、 std::basic_ios 类模板与数个 typedef | |
| 输入/输出库中所有类的前置声明 | |
| 数个标准流对象 | |
| std::basic_istream 类模板与数个 typedef | |
| std::basic_ostream 、 std::basic_iostream 类模板与数个 typedef | |
|
(C++23)
|
格式化输出库，包含 std::print |
|
(C++23)
|
std::basic_spanstream、std::basic_ispanstream、std::basic_ospanstream 类模板与 typedef |
| std::basic_stringstream、std::basic_istringstream、std::basic_ostringstream 类模板与数个 typedef | |
| std::basic_streambuf 类模板 | |
|
(C++98 中弃用)(C++26 中移除)
|
std::strstream、std::istrstream、std::ostrstream |
|
(C++20)
|
std::basic_osyncstream、std::basic_syncbuf 及 typedef |
文件系统库 |
|
|
(C++17)
|
std::path 类与支持函数 |
正则表达式库 |
|
|
(C++11)
|
支持正则表达式处理的类、算法及迭代器 |
原子操作库 |
|
|
(C++11)
|
原子操作库 |
线程支持库 |
|
|
(C++20)
|
屏障 |
|
(C++11)
|
线程等待条件 |
|
(C++11)
|
异步计算元件 |
|
(C++26)
|
风险指针 |
|
(C++20)
|
闩 |
|
(C++11)
|
互斥元件 |
|
(C++26)
|
读-拷贝更新机制 |
|
(C++20)
|
信号量 |
|
(C++14)
|
共享互斥元件 |
|
(C++20)
|
std::jthread 的停止令牌 |
|
(C++11)
|
std::thread 类与支持函数 |
C 兼容标头
对于一些形式为 xxx.h 的 C 标准库标头，C++ 标准库同时包含同名的标头和拥有形式 cxxx 的标头（所有有意义的 cxxx 标头列于上方）。形为 xxx.h 的标头有意仅用于互操作。C++ 源文件有可能需要包含这些标头之一以作为合法的 ISO C。不有意同样成为合法 ISO C 的源文件不应使用任何 C 标头。
除了 complex.h 这一例外，C++ 标准库中包含的每个 xxx.h 标头都将其对应的 cxxx 中本应置于 std 命名空间中的每个名字放在全局命名空间中。
允许这些标头也在 std 命名空间中声明同样的名字，而且允许对应的 cxxx 标头也在全局命名空间中声明同样的名字：包含 <cstdlib> 肯定会提供 std::malloc，亦可提供 ::malloc。包含 <stdlib.h> 肯定会提供 ::malloc，亦可提供 std::malloc。这甚至适用于并非 C 标准库一部分的函数和函数重载。
注：xxx.h 标头在 C++98 中弃用并在 C++23 中解除弃用。对纯 C++ 代码不鼓励使用这些标头，但它们不会在将来被移除。
| 表现同 <cassert> | |
| 表现如同将每个来自 <cctype> 的名字置于全局命名空间 | |
| 表现同 <cerrno> | |
|
(C++11)
|
表现如同将每个来自 <cfenv> 的名字置于全局命名空间 |
| 表现同 <cfloat> | |
|
(C++11)
|
表现如同将每个来自 <cinttypes> 的名字置于全局命名空间 |
| 表现同 <climits> | |
| 表现如同将每个来自 <clocale> 的名字置于全局命名空间 | |
| 表现如同将除了数学特殊函数的名字外的 每个来自 <cmath> 的名字置于全局命名空间 |
|
| 表现如同将每个来自 <csetjmp> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <csignal> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <cstdarg> 的名字置于全局命名空间 | |
表现如同将除了 std::byte 与相关函数的名字之外的每个来自 <cstddef> 的名字置于全局命名空间 |
|
|
(C++11)
|
表现如同将每个来自 <cstdint> 的名字置于全局命名空间 |
| 表现如同将每个来自 <cstdio> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <cstdlib> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <cstring> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <ctime> 的名字置于全局命名空间 | |
|
(C++11)
|
表现如同将每个来自 <cuchar> 的名字置于全局命名空间 |
| 表现如同将每个来自 <cwchar> 的名字置于全局命名空间 | |
| 表现如同将每个来自 <cwctype> 的名字置于全局命名空间 |
特殊 C 兼容标头
标头 <stdatomic.h> 声明 C 标准库中亦提供的名称，并定义在 C 中为关键词的 _Atomic 宏。不同于其他 xxx.h 标头，不提供对应的 <cstdatomic>。
|
(C++23)
|
定义 _Atomic 并提供 C 标准库中的对应组件 |
空的 C 标头
标头 <complex.h>、<ccomplex>、<tgmath.h> 和 <ctgmath> 不含有任何来自 C 标准库的内容，而且不过是包含其他来自 C++ 标准库的标头。
|
(C++11)(C++17 中弃用)(C++20 中移除)
|
简单地包含头文件 <complex> |
|
(C++11)
|
简单地包含头文件 <complex> |
|
(C++11)(C++17 中弃用)(C++20 中移除)
|
简单地包含头文件 <complex> 与 <cmath> ：等价于 C 头文件 tgmath.h 的重载已于前述头文件提供 |
|
(C++11)
|
简单地包含头文件 <complex> 与 <cmath> |
无意义的 C 标头
标头 <ciso646>、<cstdalign> 及 <cstdbool> 在 C++ 中无意义，因为它们在 C 中提供的宏是 C++ 的关键词。
|
(C++20 中移除)
|
空头文件。 C 中 iso646.h 中出现的宏是 C++ 中的关键词 |
|
(C++11)(C++17 中弃用)(C++20 中移除)
|
定义一个兼容性宏常量 |
|
(C++11)(C++17 中弃用)(C++20 中移除)
|
定义一个兼容性宏常量 |
| 无效果 | |
|
(C++11)
|
定义一个兼容性宏常量 |
|
(C++11)
|
定义一个兼容性宏常量 |
不受支持的 C 标头
C++ 不包含 C 标头 <stdatomic.h>、 (C++23 前)<stdnoreturn.h> 和 <threads.h> 而且它们没有 cxxx 等价版本。
实验性库
C++ TR/TS 也定义了数个标头的汇集。