std::basic_stacktrace
来自cppreference.com
定义于头文件 <stacktrace>
|
||
template< class Allocator > class basic_stacktrace; |
(1) | (C++23 起) |
using stacktrace = std::basic_stacktrace<std::allocator<std::stacktrace_entry>>; |
(2) | (C++23 起) |
namespace pmr { using stacktrace = |
(3) | (C++23 起) |
1)
basic_stacktrace
类模板表示整个栈踪或其给定部分的快照。它满足知分配器容器 (AllocatorAwareContainer) 、序列容器 (SequenceContainer) 及可逆容器 (ReversibleContainer) 的要求,除了仅支持移动、复制、交换和 const 限定的顺序容器上的操作,以及比较函数的语义不同于对容器所要求的语义。当前执行线程中的当前求值 x0 的调用序列是求值的序列 (x0, ..., xn) ,它使得对于 i≥0 , xi 在函数调用 xi+1 内。
栈踪是调用序列的近似表示,由栈踪条目组成。
每个栈踪条目表示栈踪中的一个求值。在 C++ 标准库中它由 std::stacktrace_entry 表示。
模板形参
Allocator | - | 用于获取/释放内存及构造/销毁该内存中的元素的分配器。类型必须符合分配器 (Allocator) 的要求。若 Allocator::value_type 不是 std::stacktrace_entry 则程序非良构。
|
成员类型
成员类型 | 定义 |
value_type (C++23)
|
std::stacktrace_entry |
const_reference (C++23)
|
const value_type& |
reference (C++23)
|
value_type& |
const_iterator (C++23)
|
实现定义的常老式随机访问迭代器 (LegacyRandomAccessIterator) 类型,实现 random_access_iterator
|
iterator (C++23)
|
const_iterator
|
reverse_iterator (C++23)
|
std::reverse_iterator<iterator> |
reverse_const_iterator (C++23)
|
std::reverse_iterator<const_iterator> |
difference_type (C++23)
|
实现定义的有符号整数类型 |
size_type (C++23)
|
实现定义的无符号整数类型 |
allocator_type (C++23)
|
Allocator
|
成员函数
(C++23) |
创建新的 basic_stacktrace (公开成员函数) |
(C++23) |
销毁 basic_stacktrace (公开成员函数) |
(C++23) |
赋值给 basic_stacktrace (公开成员函数) |
[静态] (C++23) |
获得当前栈踪或其给定部分 (公开静态成员函数) |
(C++23) |
返回关联的分配器 (公开成员函数) |
迭代器 | |
(C++23) |
返回指向起始的迭代器 (公开成员函数) |
(C++23) |
返回指向末尾的迭代器 (公开成员函数) |
(C++23) |
返回指向起始的逆向迭代器 (公开成员函数) |
(C++23) |
返回指向末尾的迭代器 (公开成员函数) |
容量 | |
(C++23) |
检查 basic_stacktrace 是否为空 (公开成员函数) |
(C++23) |
返回栈踪条目的数量 (公开成员函数) |
(C++23) |
返回栈踪条目的最大可能数量 (公开成员函数) |
元素访问 | |
(C++23) |
访问指定的栈踪条目 (公开成员函数) |
(C++23) |
访问指定的栈踪条目,带边界检查 (公开成员函数) |
修改器 | |
(C++23) |
交换内容 (公开成员函数) |
非成员函数
(C++23) |
比较二个 basic_stacktrace 值的大小与内容 (函数模板) |
特化 std::swap 算法 (函数模板) | |
(C++23) |
返回拥有 basic_stacktrace 的描述的字符串 (函数模板) |
(C++23) |
进行 basic_stracktrace 的流输出 (函数模板) |
辅助类
std::basic_stacktrace 的散列支持 (类模板特化) |
注解
定制分配器的支持是为在热路径上或嵌入式环境中使用 basic_stacktrace
而提供的。用户能在栈或其他适合的位置分配 stacktrace_entry
对象。
std::basic_stacktrace
所拥有的 std::stacktrace_entry 对象序列是不可变的,而且要么为空,要么表示整个栈踪的一个连续区间。
boost::stacktrace::basic_stacktrace
(可用于 Boost.Stacktrace )能在 std::basic_stacktrace
不可用时作为代替。
示例
本节未完成 原因:暂无示例 |
参阅
(C++23) |
栈踪中求值的表示 (类) |