std::basic_stacktrace<Allocator>::current

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Diagnostics library

Exception handling
exception
uncaught_exceptionuncaught_exceptions (until 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)
Exception handling failures
terminate
terminate_handler
get_terminate (C++11)
set_terminate
bad_exception
unexpected (until C++17*)
unexpected_handler (until C++17*)
get_unexpected (until C++17*)
set_unexpected (until C++17*)
Error numbers
Error codes
errno
Assertions
assert

Exception categories
logic_error
invalid_argument
domain_error
length_error
out_of_range
runtime_error
range_error
overflow_error
underflow_error
tx_exception (TM TS)
System error
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)
Stacktrace
stacktrace_entry (C++23)
basic_stacktrace (C++23)
Debugging support
is_debugger_present (C++26)
breakpoint_if_debugging (C++26)
breakpoint (C++26)

[edit]

std::basic_stacktrace

Member functions
basic_stacktrace::basic_stacktrace
basic_stacktrace::~basic_stacktrace
basic_stacktrace::operator=
basic_stacktrace::current
basic_stacktrace::get_allocator
Iterators
basic_stacktrace::beginbasic_stacktrace::cbegin
basic_stacktrace::endbasic_stacktrace::cend
basic_stacktrace::rbeginbasic_stacktrace::crbegin
basic_stacktrace::rendbasic_stacktrace::crend
Capacity
basic_stacktrace::empty
basic_stacktrace::size
basic_stacktrace::max_size
Element access
basic_stacktrace::operator[]
basic_stacktrace::at
Modifiers
basic_stacktrace::swap
Non-member functions
operator== operator<=>
swap(std::basic_stacktrace)
to_string(std::basic_stacktrace)
operator<<
Helper classes
hash<std::basic_stacktrace>
formatter<std::basic_stacktrace>

[edit]

static basic_stacktrace current(const allocator_type& alloc= allocator_type())noexcept;	(1)	(since C++23)
static basic_stacktrace current( size_type skip,const allocator_type& alloc= allocator_type())noexcept;	(2)	(since C++23)
static basic_stacktrace current( size_type skip, size_type max_depth, const allocator_type& alloc= allocator_type())noexcept;	(3)	(since C++23)

Lets[i] (0 ≤i <n) denote the (i+1)-th stacktrace entry in the stacktrace of the current evaluation in the current thread of execution, wheren is the count of the stacktrace entries in the stackentry.

1) Attempts to create abasic_stacktrace consisting ofs[0],s[1], ...,s[n-1].

2) Attempts to create abasic_stacktrace consisting ofs[m],s[m+1], ...,s[n-1], wherem ismin(skip,n).

3) Attempts to create abasic_stacktrace consisting ofs[m],s[m+1], ...,s[o-1], wherem ismin(skip,n) ando ismin(skip + max_depth,n). The behavior is undefined if theskip+ max_depth< skip (i.e. the mathematical result ofskip+ max_depth overflows).

In all cases,alloc is stored into the createdbasic_stacktrace and used to allocate the storage for stacktrace entries.

[edit]Parameters

alloc	-	allocator to use for all memory allocations of the constructed`basic_stacktrace`
skip	-	the number of stacktrace entries to skip
max_depth	-	the maximum depth of the stacktrace entries

[edit]Return value

If the allocation succeeds, thebasic_stacktrace described above.

Otherwise, an emptybasic_stacktrace.

[edit]Example

This section is incomplete
Reason: no example

[edit]See also

(constructor)	creates a new`basic_stacktrace` (public member function)[edit]
current [static]	constructs a new`source_location` corresponding to the location of the call site (public static member function of`std::source_location`)[edit]