SysTutorials

Linux Manual Pages › Section 3

stdbad_exception(3)

std::bad_exception – std::bad_exception

Synopsis

Defined in header <exception>
class bad_exception;

std::bad_exception is the type of the exception thrown by the C++ runtime in the following situations:
1) If std::exception_ptr stores a copy of the caught exception and if the copy constructor of the exception object caught by std::current_exception throws an exception, the captured exception is an instance of std::bad_exception.
2) If a dynamic_exception_specification is violated and std::unexpected throws or rethrows an exception that still violates the exception specification, but the exception specification allows std::bad_exception, std::bad_exception is thrown. (until C++17)
 std-bad exception-inheritance.svg
Inheritance diagram

Member functions

              constructs the bad_exception object
constructor (public member function)
              copies the object
operator= (public member function)

what returns the explanatory string
              (virtual public member function)
[virtual]

Inherited from std::exception

Member functions

destructor destroys the exception object
             (virtual public member function of std::exception)
[virtual]

what returns an explanatory string
             (virtual public member function of std::exception)
[virtual]

Example

// Run this code

#include <iostream>
#include <exception>
#include <stdexcept>
void my_unexp()
{
    throw;
}
void test() throw(std::bad_exception)
{
    throw std::runtime_error("test");
}
int main()
{
    std::set_unexpected(my_unexp);
    try {
        test();
    } catch (const std::bad_exception &e) {
        std::cerr << "Caught " << e.what() << '
';
    }
}

Output:

  Caught std::bad_exception