libstdc++
Exceptions
Collaboration diagram for Exceptions:

Classes

class  __cxxabiv1::__forced_unwind
 
struct  __gnu_cxx::forced_error
 
class  std::__exception_ptr::exception_ptr
 
class  std::bad_alloc
 
class  std::bad_cast
 
class  std::bad_exception
 
class  std::bad_function_call
 
class  std::bad_typeid
 
class  std::bad_weak_ptr
 
class  std::domain_error
 
class  std::exception
 
class  std::experimental::fundamentals_v1::bad_any_cast
 
class  std::experimental::fundamentals_v1::bad_optional_access
 
class  std::future_error
 
class  std::invalid_argument
 
class  std::ios_base::failure
 
class  std::length_error
 
class  std::logic_error
 
class  std::nested_exception
 
class  std::out_of_range
 
class  std::overflow_error
 
class  std::range_error
 
class  std::regex_error
 
class  std::runtime_error
 
class  std::system_error
 
class  std::underflow_error
 

Macros

#define __cpp_lib_uncaught_exceptions
 

Typedefs

template<typename _Tp >
using std::__rethrow_if_nested_cond = typename enable_if< __and_< is_polymorphic< _Tp >, __or_< __not_< is_base_of< nested_exception, _Tp > >, is_convertible< _Tp *, nested_exception * > > >::value >::type
 
typedef void(* std::terminate_handler) ()
 
typedef void(* std::unexpected_handler) ()
 

Functions

 std::_Nested_exception< _Except >::_Nested_exception (_Except &&__ex)
 
 std::_Nested_exception< _Except >::_Nested_exception (const _Except &__ex)
 
 std::domain_error::domain_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::domain_error::domain_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::__exception_ptr::exception_ptr::exception_ptr (const exception_ptr &) noexcept
 
 std::__exception_ptr::exception_ptr::exception_ptr (exception_ptr &&__o) noexcept
 
 std::__exception_ptr::exception_ptr::exception_ptr (nullptr_t) noexcept
 
 std::invalid_argument::invalid_argument (const char *) _GLIBCXX_TXN_SAFE
 
 std::invalid_argument::invalid_argument (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::length_error::length_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::length_error::length_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::logic_error::logic_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::logic_error::logic_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::nested_exception::nested_exception (const nested_exception &) noexcept=default
 
 std::out_of_range::out_of_range (const char *) _GLIBCXX_TXN_SAFE
 
 std::out_of_range::out_of_range (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::overflow_error::overflow_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::overflow_error::overflow_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::range_error::range_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::range_error::range_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::runtime_error::runtime_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::runtime_error::runtime_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
 std::underflow_error::underflow_error (const char *) _GLIBCXX_TXN_SAFE
 
 std::underflow_error::underflow_error (const string &__arg) _GLIBCXX_TXN_SAFE
 
const class std::type_infostd::__exception_ptr::exception_ptr::__cxa_exception_type () const noexcept __attribute__((__pure__))
 
template<typename _Ex >
__rethrow_if_nested_cond< _Exstd::__rethrow_if_nested_impl (const _Ex *__ptr)
 
void std::__rethrow_if_nested_impl (const void *)
 
template<typename _Tp >
void std::__throw_with_nested_impl (_Tp &&__t, false_type)
 
template<typename _Tp >
void std::__throw_with_nested_impl (_Tp &&__t, true_type)
 
void __gnu_cxx::__verbose_terminate_handler ()
 
template<typename _Ex >
exception_ptr std::copy_exception (_Ex __ex) noexcept 1
 
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
 
exception_ptr std::nested_exception::nested_ptr () const noexcept
 
 std::__exception_ptr::exception_ptr::operator bool () const
 
bool std::__exception_ptr::operator!= (const exception_ptr &, const exception_ptr &) noexcept __attribute__((__pure__))
 
exception_ptrstd::__exception_ptr::exception_ptr::operator= (const exception_ptr &) noexcept
 
nested_exceptionstd::nested_exception::operator= (const nested_exception &) noexcept=default
 
exception_ptrstd::__exception_ptr::exception_ptr::operator= (exception_ptr &&__o) noexcept
 
bool std::__exception_ptr::operator== (const exception_ptr &, const exception_ptr &) noexcept __attribute__((__pure__))
 
void std::rethrow_exception (exception_ptr) __attribute__((__noreturn__))
 
template<typename _Ex >
void std::rethrow_if_nested (const _Ex &__ex)
 
void std::nested_exception::rethrow_nested () const
 
terminate_handler std::set_terminate (terminate_handler) noexcept
 
unexpected_handler std::set_unexpected (unexpected_handler) noexcept
 
void std::__exception_ptr::exception_ptr::swap (exception_ptr &) noexcept
 
void std::__exception_ptr::swap (exception_ptr &__lhs, exception_ptr &__rhs)
 
void std::terminate () noexcept __attribute__((__noreturn__))
 
template<typename _Tp >
void std::throw_with_nested (_Tp &&__t)
 
bool std::uncaught_exception () noexcept __attribute__((__pure__))
 
int std::uncaught_exceptions () noexcept __attribute__((__pure__))
 
void std::unexpected () __attribute__((__noreturn__))
 
virtual const char * std::logic_error::what () const _GLIBCXX_TXN_SAFE_DYN noexcept
 
virtual const char * std::runtime_error::what () const _GLIBCXX_TXN_SAFE_DYN noexcept
 
virtual const char * std::exception::what () const _GLIBCXX_TXN_SAFE_DYN noexcept
 
virtual const char * std::bad_exception::what () const _GLIBCXX_TXN_SAFE_DYN noexcept
 

Friends

bool std::__exception_ptr::exception_ptr::operator== (const exception_ptr &, const exception_ptr &) noexcept __attribute__((__pure__))
 
exception_ptr std::__exception_ptr::exception_ptr::std::current_exception () noexcept
 
void std::__exception_ptr::exception_ptr::std::rethrow_exception (exception_ptr)
 

Detailed Description

Classes and functions for reporting errors via exception classes.

Macro Definition Documentation

◆ __cpp_lib_uncaught_exceptions

#define __cpp_lib_uncaught_exceptions

Definition at line 134 of file exception.

Typedef Documentation

◆ __rethrow_if_nested_cond

template<typename _Tp >
using std::__rethrow_if_nested_cond = typedef typename enable_if< __and_<is_polymorphic<_Tp>, __or_<__not_<is_base_of<nested_exception, _Tp> >, is_convertible<_Tp*, nested_exception*> >>::value >::type

Definition at line 132 of file nested_exception.h.

◆ terminate_handler

typedef void(* std::terminate_handler) ()

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

Definition at line 91 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 94 of file exception.

Function Documentation

◆ _Nested_exception() [1/2]

template<typename _Except >
std::_Nested_exception< _Except >::_Nested_exception ( _Except &&  __ex)
inlineexplicit

Definition at line 92 of file nested_exception.h.

◆ _Nested_exception() [2/2]

template<typename _Except >
std::_Nested_exception< _Except >::_Nested_exception ( const _Except &  __ex)
inlineexplicit

Definition at line 88 of file nested_exception.h.

◆ bad_exception()

std::bad_exception::bad_exception ( )
inlinenoexcept

Definition at line 79 of file exception.

◆ exception()

std::exception::exception ( )
inlinenoexcept

Definition at line 65 of file exception.

◆ exception_ptr() [1/2]

std::__exception_ptr::exception_ptr::exception_ptr ( exception_ptr &&  __o)
inlinenoexcept

Definition at line 103 of file exception_ptr.h.

◆ exception_ptr() [2/2]

std::__exception_ptr::exception_ptr::exception_ptr ( nullptr_t  )
inlinenoexcept

Definition at line 99 of file exception_ptr.h.

◆ logic_error()

std::logic_error::logic_error ( const string __arg)
explicit

Takes a character string describing the error.

◆ nested_exception()

std::nested_exception::nested_exception ( )
inlinenoexcept

Definition at line 63 of file nested_exception.h.

◆ runtime_error()

std::runtime_error::runtime_error ( const string __arg)
explicit

Takes a character string describing the error.

◆ __rethrow_if_nested_impl() [1/2]

template<typename _Ex >
__rethrow_if_nested_cond< _Ex > std::__rethrow_if_nested_impl ( const _Ex __ptr)
inline

Definition at line 141 of file nested_exception.h.

◆ __rethrow_if_nested_impl() [2/2]

void std::__rethrow_if_nested_impl ( const void )
inline

Definition at line 149 of file nested_exception.h.

◆ __throw_with_nested_impl() [1/2]

template<typename _Tp >
void std::__throw_with_nested_impl ( _Tp &&  __t,
false_type   
)
inline

Definition at line 110 of file nested_exception.h.

◆ __throw_with_nested_impl() [2/2]

template<typename _Tp >
void std::__throw_with_nested_impl ( _Tp &&  __t,
true_type   
)
inline

Definition at line 102 of file nested_exception.h.

◆ __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.

◆ copy_exception()

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

Obtain an exception_ptr pointing to a copy of the supplied object. This function is deprecated, use std::make_exception_ptr instead.

Definition at line 199 of file exception_ptr.h.

◆ 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.

Referenced by std::make_exception_ptr().

◆ 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 173 of file exception_ptr.h.

References std::current_exception().

◆ nested_ptr()

exception_ptr std::nested_exception::nested_ptr ( ) const
inlinenoexcept

Definition at line 81 of file nested_exception.h.

◆ operator bool()

std::__exception_ptr::exception_ptr::operator bool ( ) const
inlineexplicit

Definition at line 142 of file exception_ptr.h.

◆ operator=()

exception_ptr & std::__exception_ptr::exception_ptr::operator= ( exception_ptr &&  __o)
inlinenoexcept

Definition at line 120 of file exception_ptr.h.

◆ rethrow_exception()

void std::rethrow_exception ( exception_ptr  )

Throw the object pointed to by the exception_ptr.

References std::rethrow_exception().

Referenced by std::rethrow_exception().

◆ 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 155 of file nested_exception.h.

References std::__addressof().

◆ rethrow_nested()

void std::nested_exception::rethrow_nested ( ) const
inline

Definition at line 73 of file nested_exception.h.

◆ 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.

◆ swap()

void std::__exception_ptr::swap ( exception_ptr __lhs,
exception_ptr __rhs 
)
inline

Definition at line 164 of file exception_ptr.h.

◆ 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).'

◆ 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.

◆ what() [1/4]

virtual const char * std::logic_error::what ( ) const
virtualnoexcept

Returns a C-style character string describing the general cause of the current error (the same string passed to the ctor).

Reimplemented from std::exception.

Reimplemented in std::future_error.

◆ what() [2/4]

virtual const char * std::runtime_error::what ( ) const
virtualnoexcept

Returns a C-style character string describing the general cause of the current error (the same string passed to the ctor).

Reimplemented from std::exception.

◆ what() [3/4]

virtual const char * std::exception::what ( ) const
virtualnoexcept

◆ what() [4/4]

virtual const char * std::bad_exception::what ( ) const
virtualnoexcept

Returns a C-style character string describing the general cause of the current error.

Reimplemented from std::exception.