std::basic_stacktrace

来自cppreference.com
< cpp‎ | utility
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
basic_stacktrace
(C++23)
 
 
定义于头文件 <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 =
    std::basic_stacktrace<std::polymorphic_allocator<std::stacktrace_enty>>;

}
(3) (C++23 起)
1) basic_stacktrace 类模板表示整个栈踪或其给定部分的快照。它满足知分配器容器 (AllocatorAwareContainer) 序列容器 (SequenceContainer) 可逆容器 (ReversibleContainer) 的要求,除了仅支持移动、复制、交换和 const 限定的顺序容器上的操作,以及比较函数的语义不同于对容器所要求的语义。
2) 使用默认 std::allocatorbasic_stacktrace 的便利类型别名。
3) 使用多态分配器basic_stacktrace 的便利类型别名。

当前执行线程中的当前求值 x0调用序列是求值的序列 (x0, ..., xn) ,它使得对于 i≥0xi 在函数调用 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

成员函数

创建新的 basic_stacktrace
(公开成员函数)
销毁 basic_stacktrace
(公开成员函数)
(C++23)
赋值给 basic_stacktrace
(公开成员函数)
[静态] (C++23)
获得当前栈踪或其给定部分
(公开静态成员函数)
返回关联的分配器
(公开成员函数)
迭代器
返回指向起始的迭代器
(公开成员函数)
(C++23)
返回指向末尾的迭代器
(公开成员函数)
返回指向起始的逆向迭代器
(公开成员函数)
(C++23)
返回指向末尾的迭代器
(公开成员函数)
容量
(C++23)
检查 basic_stacktrace 是否为空
(公开成员函数)
(C++23)
返回栈踪条目的数量
(公开成员函数)
(C++23)
返回栈踪条目的最大可能数量
(公开成员函数)
元素访问
访问指定的栈踪条目
(公开成员函数)
(C++23)
访问指定的栈踪条目,带边界检查
(公开成员函数)
修改器
(C++23)
交换内容
(公开成员函数)

非成员函数

比较二个 basic_stacktrace 值的大小与内容
(函数模板)
特化 std::swap 算法
(函数模板)
(C++23)
返回拥有 basic_stacktrace 的描述的字符串
(函数模板)
进行 basic_stracktrace 的流输出
(函数模板)

辅助类

std::basic_stacktrace 的散列支持
(类模板特化)

注解

定制分配器的支持是为在热路径上或嵌入式环境中使用 basic_stacktrace 而提供的。用户能在栈或其他适合的位置分配 stacktrace_entry 对象。

std::basic_stacktrace 所拥有的 std::stacktrace_entry 对象序列是不可变的,而且要么为空,要么表示整个栈踪的一个连续区间。

boost::stacktrace::basic_stacktrace (可用于 Boost.Stacktrace )能在 std::basic_stacktrace 不可用时作为代替。

示例

参阅

栈踪中求值的表示
(类)