std::basic_stacktrace

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека диагностики

Обработка исключений exception uncaught_exceptionuncaught_exceptions (до C++20*)(C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Сбои обработки исключений terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (до C++17*) unexpected_handler (до C++17*) get_unexpected (C++11)(до C++17*)     set_unexpected (до C++17*) Коды ошибок Коды ошибок errno

Категории исключений logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (ТС TM) Поддержка системных ошибок error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Утверждения assert Трассировка стека stacktrace_entry (C++23) basic_stacktrace (C++23)

 

std::basic_stacktrace

Функции-элементы

basic_stacktrace::basic_stacktrace

basic_stacktrace::~basic_stacktrace

basic_stacktrace::operator=

basic_stacktrace::current

basic_stacktrace::get_allocator

Итераторы

basic_stacktrace::beginbasic_stacktrace::cbegin

basic_stacktrace::endbasic_stacktrace::cend

basic_stacktrace::rbeginbasic_stacktrace::crbegin

basic_stacktrace::rendbasic_stacktrace::crend

Ёмкость

basic_stacktrace::empty

basic_stacktrace::size

basic_stacktrace::max_size

Доступ к элементам

basic_stacktrace::operator[]

basic_stacktrace::at

Модификаторы

basic_stacktrace::swap

Функции, не являющиеся элементами

operator== operator<=> (C++23)(C++23)

std::swap

std::to_string

operator<<

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

std::hash<std::basic_stacktrace>

std::formatter<std::basic_stacktrace>

 

<tbody> </tbody>

Определено в заголовочном файле <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::pmr::polymorphic_allocator<std::stacktrace_entry>>; }	(3)	(начиная с C++23)

1) Шаблон класса basic_stacktrace представляет собой снимок всей трассировки стека или её заданной части. Он соответствует требованиям AllocatorAwareContainer, SequenceContainer и ReversibleContainer, за исключением того, что поддерживаются только перемещение, присваивание, обмен и операции для const квалифицированных последовательных контейнеров, а семантика функций сравнения отличается от требуемой для контейнера.

2) Удобный псевдоним типа для basic_stacktrace с использованием значения по умолчанию std::allocator.

3) Удобный псевдоним типа для 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.

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

Allocator

—

Аллокатор, который используется для получения/освобождения памяти и создания/уничтожения элементов в этой памяти. Тип должен соответствовать требованиям Allocator. Программа некорректна, если Allocator::value_type не std::stacktrace_entry.

Элементы типы

Тип элемент	Определение
value_type	std::stacktrace_entry
const_reference	const value_type&
reference	value_type&
const_iterator	определяемый реализацией константный тип LegacyRandomAccessIterator, который моделирует random_access_iterator
iterator	const_iterator
reverse_iterator	std::reverse_iterator<iterator>
reverse_const_iterator	std::reverse_iterator<const_iterator>
difference_type	определяемый реализацией целочисленный тип со знаком
size_type	определяемый реализацией беззнаковый целочисленный тип
allocator_type	Allocator

Функции-элементы

(конструктор)	создаёт новый basic_stacktrace (public функция-элемент)
(деструктор)	уничтожает basic_stacktrace (public функция-элемент)
operator=	присваивает классу basic_stacktrace (public функция-элемент)
current [static]	получает текущую трассировку стека или её заданную часть (public static функция-элемент)
get_allocator	возвращает связанный аллокатор (public функция-элемент)
Итераторы
begincbegin	возвращает итератор на начало (public функция-элемент)
endcend	возвращает итератор на конец (public функция-элемент)
rbegincrbegin	возвращает обратный итератор на начало (public функция-элемент)
rendcrend	возвращает обратный итератор на конец (public функция-элемент)
Ёмкость
empty	проверяет, пуст ли basic_stacktrace (public функция-элемент)
size	возвращает количество записей трассировки стека (public функция-элемент)
max_size	возвращает максимально возможное количество записей трассировки стека (public функция-элемент)
Доступ к элементам
operator[]	получает доступ к указанной записи трассировки стека (public функция-элемент)
at	доступ к указанной записи трассировки стека с проверкой границ (public функция-элемент)
Модификаторы
swap	обменивает содержимое (public функция-элемент)

Функции, не являющиеся элементами

operator==operator<=> (C++23)	сравнивает размеры и содержимое двух значений basic_stacktrace (шаблон функции)
std::swap(std::basic_stacktrace) (C++23)	специализация алгоритма std::swap (шаблон функции)
to_string (C++23)	возвращает строку с описанием класса basic_stacktrace (шаблон функции)
operator<< (C++23)	выполняет потоковый вывод класса basic_stracktrace (шаблон функции)

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

std::hash<std::basic_stacktrace> (C++23)	поддержка хэширования для std::basic_stacktrace (специализация шаблона класса)
std::formatter<std::basic_stacktrace> (C++23)	поддержка форматирования для basic_stacktrace (специализация шаблона класса)

Примечание

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

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

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

Макрос тест функциональности	Значение	Стандарт	Комментарий
__cpp_lib_stacktrace	202011L	(C++23)	Библиотека трассировки стека
__cpp_lib_formatters	202302L	(C++23)	Форматирование std::thread::id и std::stacktrace

Пример

Вывод, полученный с помощью Compiler Explorer: msvc и gcc.

Запустить этот код

#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

Смотрите также

stacktrace_entry (C++23)

представление вычисления в трассировке стека (класс)