std::basic_stacktrace

Последовательность вызова текущей оценки \(\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.

Трассировка стека является приблизительным представлением последовательности вызовов и состоит из записей трассировки стека.

Запись трассировки стека представляет оценку в трассировке стека. В стандартной библиотеке C++ она представлена std::stacktrace_entry.

[править] Параметры шаблона

[править] Элементы типы

[править] Функции-элементы

[править] Функции, не являющиеся элементами

[править] Вспомогательные классы

[править] Примечание

Предусмотрена поддержка пользовательских аллокаторов для использования 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 (строки, заканчивающиеся стрелками '⤶', разделены по ширине):
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

[править] Смотрите также