Заголовочный файл стандартной библиотеки <stacktrace> (C++23)

 

C++

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

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

Язык

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

Языковая поддержка
<cstddef> <cstdlib> <version>(C++20) <limits> <climits>	<cfloat> <cstdint>(C++11) <stdfloat>(C++23) <new> <typeinfo>	<source_location>(C++20) <exception> <initializer_list>(C++11) <compare>(C++20)	<coroutine>(C++20) <csignal> <csetjmp> <cstdarg>
Концепты
<concepts>(C++20)
Диагностика
<stdexcept> <stacktrace>(C++23)	<cassert>	<cerrno>	<system_error>(C++11)
Управление памятью
<memory>	<memory_resource>(C++17)	<scoped_allocator>(C++11)
Метапрограммирование
<type_traits>(C++11)	<ratio>(C++11)
Общие утилиты
<utility> <tuple>(C++11) <optional>(C++17) <variant>(C++17)	<any>(C++17) <expected>(C++23) <bitset>	<functional> <typeindex>(C++11) <execution>(C++17)	<charconv>(C++17) <format>(C++20) <bit>(C++20)
Строки
<string_view>(C++17) <string>	<cctype> <cwctype>	<cstring> <cwchar>	<cuchar>(C++11)
Контейнеры
<array>(C++11) <deque> <forward_list>(C++11) <list>	<vector> <map> <set> <unordered_map>(C++11)	<unordered_set>(C++11) <queue> <stack> <flat_map>(C++23)	<flat_set>(C++23) <span>(C++20) <mdspan>(C++23)
Итераторы
<iterator>
Диапазоны
<ranges>(C++20)	<generator>(C++23)
Алгоритмы
<algorithm>	<numeric>
Числа
<cfenv>(C++11) <complex>	<random>(C++11) <valarray>	<cmath>	<numbers>(C++20)
Время
<chrono>(C++11)	<ctime>
Локализация
<locale>	<clocale>	<codecvt>(C++11/17*)
Ввод/вывод
<iosfwd> <iostream> <ios> <streambuf>	<istream> <ostream> <iomanip> <print>(C++23)	<sstream> <spanstream>(C++23) <fstream> <syncstream>(C++20)	<filesystem>(C++17) <cstdio> <cinttypes>(C++11) <strstream>(C++98*)
Регулярные выражения
<regex>(C++11)
Поддержка конкуренции
<stop_token>(C++20) <thread>(C++11) <atomic>(C++11)	<stdatomic.h>(C++23) <mutex>(C++11) <shared_mutex>(C++14)	<condition_variable>(C++11)   <semaphore>(C++20) <latch>(C++20)	<barrier>(C++20) <future>(C++11)
Совместимость с C
<cstdbool>(C++11/17/20*)   <ccomplex>(C++11/17/20*)	<ctgmath>(C++11/17/20*)	<cstdalign>(C++11/17/20*)	<ciso646>(до C++20)

 

Этот заголовок является частью библиотеки общих утилит.

Классы
stacktrace_entry (C++23)	представление вычисления в трассировке стека (класс)
basic_stacktrace (C++23)	приблизительное представление последовательности вызовов состоит из записей трассировки стека (шаблон класса)
std::hash<std::stacktrace_entry> (C++23)	поддержка хэширования для std::stacktrace_entry (специализация шаблона класса)
std::hash<std::basic_stacktrace> (C++23)	поддержка хэширования для std::basic_stacktrace (специализация шаблона класса)
Предварительные объявления
Определены в заголовочном файле <functional>
hash (C++11)	Объект хеш-функции (шаблон класса)

Псевдонимы типов
Псевдоним	Тип
std::stacktrace	std::basic_stacktrace<std::allocator<std::stacktrace_entry>>
std::pmr::stacktrace	std::pmr::basic_stacktrace<     std::pmr::polymorphic_allocator<std::stacktrace_entry>>

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

Резюме

namespace std {// класс stacktrace_entryclass stacktrace_entry;   // шадлонный класс basic_stacktracetemplate<class Allocator>class basic_stacktrace;   // typedef имя basic_stacktraceusing stacktrace = basic_stacktrace<allocator<stacktrace_entry>>;   // функции, не являющиеся элементамиtemplate<class Allocator>void swap(basic_stacktrace<Allocator>& a, basic_stacktrace<Allocator>& b)noexcept(noexcept(a.swap(b)));   string to_string(const stacktrace_entry& f);   template<class Allocator> string to_string(const basic_stacktrace<Allocator>& st);   ostream& operator<<(ostream& os, const stacktrace_entry& f);   template<class Allocator> ostream& operator<<(ostream& os, const basic_stacktrace<Allocator>& st);   namespace pmr {using stacktrace =std::basic_stacktrace<polymorphic_allocator<stacktrace_entry>>;}   // поддержка хешированияtemplate<class T>struct hash;template<>struct hash<stacktrace_entry>;template<class Allocator>struct hash<basic_stacktrace<Allocator>>;}

Класс std::stacktrace_entry

namespace std {class stacktrace_entry {public:using native_handle_type =/* определено-реализацией */;   // конструкторыconstexpr stacktrace_entry()noexcept;constexpr stacktrace_entry(const stacktrace_entry& other)noexcept;constexpr stacktrace_entry& operator=(const stacktrace_entry& other)noexcept;   ~stacktrace_entry();   // наблюдателиconstexpr native_handle_type native_handle()constnoexcept;constexprexplicit operator bool()constnoexcept;   // запрос string description()const; string source_file()const; uint_least32_t source_line()const;   // сравненияfriendconstexprbool operator==(const stacktrace_entry& x, const stacktrace_entry& y)noexcept;friendconstexpr strong_ordering operator<=>(const stacktrace_entry& x, const stacktrace_entry& y)noexcept;};}

Шаблонный класс std::basic_stacktrace

namespace std {template<class Allocator>class basic_stacktrace {public:using value_type = stacktrace_entry;using const_reference =const value_type&;using reference = value_type&;using const_iterator =/* определено-реализацией */;using iterator = const_iterator;using reverse_iterator =std::reverse_iterator<iterator>;using const_reverse_iterator =std::reverse_iterator<const_iterator>;using difference_type =/* определено-реализацией */;using size_type =/* определено-реализацией */;using allocator_type = Allocator;   // создание и присваиваниеstatic basic_stacktrace current(const allocator_type& alloc = allocator_type())noexcept;static basic_stacktrace current(size_type skip, const allocator_type& alloc = allocator_type())noexcept;static basic_stacktrace current(size_type skip, size_type max_depth, const allocator_type& alloc = allocator_type())noexcept;   basic_stacktrace()noexcept(is_nothrow_default_constructible_v<allocator_type>);explicit basic_stacktrace(const allocator_type& alloc)noexcept;   basic_stacktrace(const basic_stacktrace& other); basic_stacktrace(basic_stacktrace&& other)noexcept; basic_stacktrace(const basic_stacktrace& other, const allocator_type& alloc); basic_stacktrace(basic_stacktrace&& other, const allocator_type& alloc); basic_stacktrace& operator=(const basic_stacktrace& other); basic_stacktrace& operator=(basic_stacktrace&& other)noexcept( allocator_traits<Allocator>::propagate_on_container_move_assignment::value|| allocator_traits<Allocator>::is_always_equal::value);   ~basic_stacktrace();   // наблюдатели allocator_type get_allocator()constnoexcept;   const_iterator begin()constnoexcept; const_iterator end()constnoexcept; const_reverse_iterator rbegin()constnoexcept; const_reverse_iterator rend()constnoexcept;   const_iterator cbegin()constnoexcept; const_iterator cend()constnoexcept; const_reverse_iterator crbegin()constnoexcept; const_reverse_iterator crend()constnoexcept;   [[nodiscard]]bool empty()constnoexcept; size_type size()constnoexcept; size_type max_size()constnoexcept;   const_reference operator[](size_type)const; const_reference at(size_type)const;   // сравненияtemplate<class Allocator2>friendbool operator==(const basic_stacktrace& x, const basic_stacktrace<Allocator2>& y)noexcept;template<class Allocator2>friend strong_ordering operator<=>(const basic_stacktrace& x, const basic_stacktrace<Allocator2>& y)noexcept;   // модификаторыvoid swap(basic_stacktrace& other)noexcept(allocator_traits<Allocator>::propagate_on_container_swap::value|| allocator_traits<Allocator>::is_always_equal::value);   private: vector<value_type, allocator_type> frames_;// только для пояснения};}