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

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

Inserts the description of st into the output stream os. Equivalent to return os << std::to_string(st);.

Parameters

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

Return value

os.

Exceptions

May throw implementation-defined exceptions.

Notes

Since std::string can only be outputted by std::ostream (not by e.g. std::wostream), it is effectively required that os be of type std::ostream&.

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

Compiler support
Freestanding and hosted
Language
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Metaprogramming library (C++11)
Diagnostics library
General utilities library
Strings library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Numerics library
Localizations library
Input/output library
Filesystem library (C++17)
Regular expressions library (C++11)
Concurrency support library (C++11)
Technical specifications
Symbols index
External libraries

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