libstdc++
Exceptions
Collaboration diagram for Exceptions:

Classes

struct  __gnu_cxx::forced_error
 

Macros

#define __cpp_lib_uncaught_exceptions
 

Typedefs

typedef void(* std::terminate_handler) ()
 
typedef void(* std::unexpected_handler) ()
 

Functions

void __gnu_cxx::__verbose_terminate_handler ()
 
exception_ptr std::current_exception () noexcept
 
terminate_handler std::get_terminate () noexcept
 
unexpected_handler std::get_unexpected () noexcept
 
template<typename _Ex >
exception_ptr std::make_exception_ptr (_Ex __ex) noexcept
 
void std::rethrow_exception (exception_ptr)
 
template<typename _Ex >
void std::rethrow_if_nested (const _Ex &__ex)
 
terminate_handler std::set_terminate (terminate_handler) noexcept
 
unexpected_handler std::set_unexpected (unexpected_handler) noexcept
 
void std::terminate () noexcept
 
template<typename _Tp >
void std::throw_with_nested (_Tp &&__t)
 
bool std::uncaught_exception () noexcept
 
int std::uncaught_exceptions () noexcept
 
void std::unexpected ()
 

Detailed Description

Classes and functions for reporting errors via exceptions.

Typedef Documentation

◆ terminate_handler

typedef void(* std::terminate_handler) ()

If you write a replacement terminate handler, it must be of this type.

Definition at line 65 of file exception.

◆ unexpected_handler

typedef void(* std::unexpected_handler) ()

If you write a replacement unexpected handler, it must be of this type.

Definition at line 68 of file exception.

Function Documentation

◆ __verbose_terminate_handler()

void __gnu_cxx::__verbose_terminate_handler ( )

A replacement for the standard terminate_handler which prints more information about the terminating exception (if any) on stderr.

Call

terminate_handler set_terminate(terminate_handler) noexcept
Takes a new handler function as an argument, returns the old function.
void __verbose_terminate_handler()
A replacement for the standard terminate_handler which prints more information about the terminating ...

to use. For more info, see http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt02ch06s02.html

In 3.4 and later, this is on by default.

◆ current_exception()

exception_ptr std::current_exception ( )
noexcept

Obtain an exception_ptr to the currently handled exception. If there is none, or the currently handled exception is foreign, return the null value.

◆ get_terminate()

terminate_handler std::get_terminate ( )
noexcept

Return the current terminate handler.

◆ get_unexpected()

unexpected_handler std::get_unexpected ( )
noexcept

Return the current unexpected handler.

◆ make_exception_ptr()

template<typename _Ex >
exception_ptr std::make_exception_ptr ( _Ex  __ex)
noexcept

Obtain an exception_ptr pointing to a copy of the supplied object.

Definition at line 233 of file exception_ptr.h.

◆ rethrow_exception()

void std::rethrow_exception ( exception_ptr  )

Throw the object pointed to by the exception_ptr.

Referenced by std::__basic_future< _Res >::_M_get_result().

◆ rethrow_if_nested()

template<typename _Ex >
void std::rethrow_if_nested ( const _Ex &  __ex)
inline

If __ex is derived from nested_exception, __ex.rethrow_nested().

Definition at line 159 of file nested_exception.h.

References std::__addressof().

◆ set_terminate()

terminate_handler std::set_terminate ( terminate_handler  )
noexcept

Takes a new handler function as an argument, returns the old function.

◆ set_unexpected()

unexpected_handler std::set_unexpected ( unexpected_handler  )
noexcept

Takes a new handler function as an argument, returns the old function.

◆ terminate()

void std::terminate ( )
noexcept

The runtime will call this function if exception handling must be abandoned for any reason. It can also be called by the user.

◆ throw_with_nested()

template<typename _Tp >
void std::throw_with_nested ( _Tp &&  __t)
inline

If __t is derived from nested_exception, throws __t. Else, throws an implementation-defined object derived from both.

Definition at line 118 of file nested_exception.h.

◆ uncaught_exception()

bool std::uncaught_exception ( )
noexcept

[18.6.4]/1: 'Returns true after completing evaluation of a throw-expression until either completing initialization of the exception-declaration in the matching handler or entering unexpected() due to the throw; or after entering terminate() for any reason other than an explicit call to terminate(). [Note: This includes stack unwinding [15.2]. end note]'

2: 'When uncaught_exception() is true, throwing an exception can result in a call of terminate() (15.5.1).'

Referenced by std::basic_ostream< _CharT, _Traits >::sentry::~sentry().

◆ uncaught_exceptions()

int std::uncaught_exceptions ( )
noexcept

The number of uncaught exceptions.

◆ unexpected()

void std::unexpected ( )

The runtime will call this function if an exception is thrown which violates the function's exception specification.