Exceptions
Diagnostics
Collaboration diagram for Exceptions:

## Classes

class | __cxxabiv1::__forced_unwind
struct | __gnu_cxx::forced_error
class | __gnu_cxx::recursive_init_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::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

## Typedefs

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

## Functions

template<typename _Ex >
const nested_exception * | std::__get_nested_exception (const _Ex &__ex)
template<typename _Ex >
void | std::__throw_with_nested (_Ex &&, const nested_exception *=0) __attribute__((__noreturn__))
template<typename _Ex >
void | std::__throw_with_nested (_Ex &&,...) __attribute__((__noreturn__))
void | __gnu_cxx::__verbose_terminate_handler ()
template<typename _Ex >
exception_ptr | std::copy_exception (_Ex __ex) noexcept
exception_ptr | std::current_exception () noexcept
template<typename _Ex >
exception_ptr | std::make_exception_ptr (_Ex __ex) noexcept
void | std::rethrow_exception (exception_ptr) __attribute__((__noreturn__))
template<typename _Ex >
void | std::rethrow_if_nested (const _Ex &__ex)
void | std::rethrow_if_nested (const nested_exception &__ex)
terminate_handler | std::set_terminate (terminate_handler) noexcept
unexpected_handler | std::set_unexpected (unexpected_handler) noexcept
void | std::terminate () noexcept __attribute__((__noreturn__))
template<typename _Ex >
void | std::throw_with_nested (_Ex __ex)
bool | std::uncaught_exception () noexcept __attribute__((__pure__))
void | std::unexpected () __attribute__((__noreturn__))

## Detailed Description

Classes and functions for reporting errors via exception classes.

## Typedef Documentation

typedef void(* std::terminate_handler)()

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

Definition at line 87 of file exception.

typedef void(* std::unexpected_handler)()

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

Definition at line 90 of file exception.

## Function Documentation

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

std::set_terminate(__gnu_cxx::__verbose_terminate_handler)

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.

template<typename _Ex >

exception_ptr std::copy_exception | ( | _Ex | __ex | ) |

noexcept

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

Definition at line 167 of file exception_ptr.h.

References std::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::copy_exception().

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

void std::rethrow_exception | ( | exception_ptr |  | ) |

Throw the object pointed to by the exception_ptr.

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

void std::rethrow_if_nested | ( | const nested_exception & | __ex | ) |

inline

Overload, See N2619.

Definition at line 154 of file nested_exception.h.

terminate_handler std::set_terminate | ( | terminate_handler |  | ) |

noexcept

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

unexpected_handler std::set_unexpected | ( | unexpected_handler |  | ) |

noexcept

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

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.

template<typename _Ex >

void std::throw_with_nested | ( | _Ex | __ex | ) |

inline

If `__ex` is derived from nested_exception, `__ex`. Else, an implementation-defined object derived from both.

Definition at line 136 of file nested_exception.h.

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().

void std::unexpected | ( |  | ) |

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