std::basic_stacktrace

template< class Allocator >
class basic_stacktrace;

using stacktrace =
    std::basic_stacktrace<std::allocator<std::stacktrace_entry>>;

namespace pmr {
using stacktrace =
    std::basic_stacktrace<std::pmr::polymorphic_allocator<std::stacktrace_entry>>;
}

Последовательность вызовов текущего вычисления \(\small{ {x}_{0} }\)x₀ в текущей потоке выполнения представляет собой последовательность \(\small{ ({x}_{0}, \dots, {x}_{n})}\)(x₀, ..., x_n) вычислений, такая что для \(\small{i \ge 0}\)i≥0, \(\small{ {x}_{i} }\)x_i находится внутри вызова функции \(\small{ {x}_{i+1} }\)x_i+1.

Стек вызовов — приблизительное представление последовательности вызовов и состоит из записей стека вызовов.

Запись стека вызовов представляет вычисление в стеке вызовов. Она представлена std::stacktrace_entry в стандартной библиотеке C++.

Параметры шаблона

Типы-члены

Члены-функции

Функции вне класса

Вспомогательные классы

Примечания

Поддержка пользовательских аллокаторов предоставляется для использования basic_stacktrace в горячих точках или встраиваемых средах. Пользователи могут выделять объекты stacktrace_entry в стеке или в другом подходящем месте.

Последовательность объектов std::stacktrace_entry, принадлежащих std::basic_stacktrace, является неизменяемой и либо пустой, либо представляет собой непрерывный интервал всего стека вызовов.

boost::stacktrace::basic_stacktrace (доступно в Boost.Stacktrace) может быть использовано вместо std::basic_stacktrace, если оно недоступно.

Пример

#include <iostream>
#include <stacktrace>
 
int nested_func(int c)
{
    std::cout << std::stacktrace::current() << '\n';
    return c + 1;
}
 
int func(int b)
{
    return nested_func(b + 1);
}
 
int main()
{
    std::cout << func(777);
}

// msvc output (the lines ending with '⤶' arrows are split to fit the width):
0> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(6): output_s!nested_func+0x1F
1> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(12): output_s!func+0x15
2> C:\Users\ContainerAdministrator\AppData\Local\Temp\compiler-explorer-compiler20221122-⤶
31624-2ja1sf.8ytzw\example.cpp(15): output_s!main+0xE
3> D:\a\_work\1\s\src\vctools\crt\vcstartup\src\startup\exe_common.inl(288): output_s!⤶
__scrt_common_main_seh+0x10C
4> KERNEL32!BaseThreadInitThunk+0x14
5> ntdll!RtlUserThreadStart+0x21
779
 
gcc output:
   0# nested_func(int) at /app/example.cpp:7
   1# func(int) at /app/example.cpp:13
   2#      at /app/example.cpp:18
   3#      at :0
   4#      at :0
   5# 
 
779

См. также