std::operator<<(std::basic_stacktrace)

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]

Defined in header`<stacktrace>`
template<class Allocator> std::ostream& operator<<(std::ostream& os,conststd::basic_stacktrace<Allocator>& st);		(since C++23)

Inserts the description ofst into the output streamos. Equivalent toreturn os<<std::to_string(st);.

[edit]Parameters

os	-	an output stream
st	-	a`basic_stacktrace` whose description is to be inserted

[edit]Return value

os.

[edit]Exceptions

May throw implementation-defined exceptions.

[edit]Example

Run this code

#include <stacktrace>#include <iostream> int main(){std::cout<<"The stacktrace obtained in the main function:\n";std::cout<< std::stacktrace::current()<<'\n';[]{std::cout<<"The stacktrace obtained in a nested lambda:\n";std::cout<< std::stacktrace::current()<<'\n';}();}

Possible output:

The stacktrace obtained in the main function: 0# 0x0000000000402E7B in ./prog.exe 1# __libc_start_main in /lib/x86_64-linux-gnu/libc.so.6 2# 0x0000000000402CD9 in ./prog.exe The stacktrace obtained in a nested lambda: 0# 0x0000000000402DDA in ./prog.exe 1# 0x0000000000402EB2 in ./prog.exe 2# __libc_start_main in /lib/x86_64-linux-gnu/libc.so.6 3# 0x0000000000402CD9 in ./prog.exe