std::stack
来自 cppreference.cn
定义于头文件 <stack> |
||
template< class T, |
||
std::stack
类是一个容器适配器,它为程序员提供了栈的功能——具体来说,是一种后进先出 (LIFO) 的数据结构。
类模板作为底层容器的包装器——只提供一组特定的函数。栈从底层容器的后端(称为栈顶)推入和弹出元素。
|
(C++26 起) |
目录 |
[编辑] 模板参数
T | - | 存储元素的类型。如果 T 与 Container::value_type 不是同一类型,则程序格式错误。 |
Container(容器) | - | 用于存储元素的底层容器类型。该容器必须满足 序列容器 (SequenceContainer) 的要求。此外,它必须提供以下具有通常语义的函数
标准容器 std::vector(包括 std::vector<bool>)、std::deque 和 std::list 满足这些要求。默认情况下,如果未为特定栈类实例化指定容器类,则使用标准容器 std::deque。 |
[编辑] 成员类型
类型 | 定义 |
container_type
|
Container |
value_type
|
Container::value_type |
size_type
|
Container::size_type |
reference
|
Container::reference |
const_reference
|
Container::const_reference |
[编辑] 成员对象
成员 | 描述 |
Container c |
底层容器 (受保护成员对象) |
[编辑] 成员函数
构造 stack (公开成员函数) | |
析构 stack (公开成员函数) | |
向容器适配器赋值 (公开成员函数) | |
元素访问 | |
访问顶部元素 (公开成员函数) | |
容量 | |
检查容器适配器是否为空 (公开成员函数) | |
返回元素数量 (公开成员函数) | |
修改器 | |
在栈顶插入元素 (公开成员函数) | |
(C++23) |
在栈顶插入一个元素范围 (公开成员函数) |
(C++11) |
在栈顶原地构造元素 (公开成员函数) |
移除顶部元素 (公开成员函数) | |
(C++11) |
交换内容 (公开成员函数) |
[编辑] 非成员函数
按字典序比较两个 stack 的值(函数模板) | |
(C++11) |
特化 std::swap 算法 (函数模板) |
[编辑] 辅助类
特化 std::uses_allocator 类型特性 (类模板特化) | |
(C++23) |
对 std::stack 的格式化支持(类模板特化) |
推导指引 |
(C++17 起) |
[编辑] 注解
特性测试宏 | 值 | 标准 | 特性 |
---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | 容器的范围构造和插入 |
__cpp_lib_constexpr_containers |
202502L |
(C++26) | constexpr std::stack |
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
---|---|---|---|
LWG 307 | C++98 | Container 不能是 std::vector<bool> |
允许 |
LWG 2566 | C++98 | 缺少 Container::value_type 的要求 |
如果 T 与 Container::value_type 不是同一类型,则格式错误 |
[编辑] 参阅
可变大小的连续数组 (类模板) | |
节省空间的动态位集 (类模板特化) | |
双端队列 (类模板) | |
双向链表 (类模板) |