std::exception - cppreference.com (original) (raw)

Provides consistent interface to handle errors through the throw expression.

All exceptions generated by the standard library inherit from std::exception.

Contents

• 1 Member functions
• 2 Standard exception requirements
• 3 Standard exceptions
• 4 Notes
• 5 Defect reports

[edit] Member functions

| | constructs the exception object (public member function) | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | destroys the exception object (virtual public member function) [edit] | | | copies exception object (public member function) [edit] | | | returns an explanatory string (virtual public member function) [edit] |

[edit] Standard exception requirements

Each standard library class T that derives from std::exception has the following publicly accessible member functions, each of them do not exit with an exception(until C++11)having a non-throwing exception specification(since C++11):

• default constructor (unless other constructors are provided)
• copy constructor
• copy assignment operator

The copy constructor and the copy assignment operator meet the following postcondition:

• If two objects lhs and rhs both have dynamic type T and lhs is a copy of rhs, then std::strcmp(lhs.what(), rhs.what()) is equal to ​0​.

The what() member function of each such T satisfies the constraints specified for std::exception::what().

[edit] Standard exceptions

• logic_error

• invalid_argument

• domain_error

• length_error

• out_of_range

• runtime_error

• range_error

• overflow_error

• underflow_error

• bad_typeid

• bad_cast

• bad_alloc

• bad_exception

[edit] Notes

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.