The class describes an exception for use with multiple inheritance. It captures the currently handled exception and stores it for later use.

class nested_exception {
    public:
        nested_exception();
        nested_exception(const nested_exception&) = default;
        virtual ~nested_exception() = default; // access functions
};

nested_exception& operator=(const nested_exception&) = default;

exception_ptr nested_ptr() const;

The stored exception captured by this nested_exception object.

[[noreturn]] void rethrow_nested() const;

If nested_ptr() returns a null pointer, the function calls std::terminate(). Otherwise, it throws the stored exception captured by *this.

Header: <exception>

Namespace: std

exception Class
Thread Safety in the C++ Standard Library