21 Language support library [language.support]

21.8 Exception handling [support.exception]

21.8.6 Exception propagation [propagation]

using exception_ptr = unspecified;

The type exception_Β­ptr can be used to refer to an exception object.

exception_Β­ptr shall satisfy the requirements of NullablePointer.

Two non-null values of type exception_Β­ptr are equivalent and compare equal if and only if they refer to the same exception.

The default constructor of exception_Β­ptr produces the null value of the type.

exception_Β­ptr shall not be implicitly convertible to any arithmetic, enumeration, or pointer type.

[ Note: An implementation might use a reference-counted smart pointer as exception_Β­ptr.  — end note ]

For purposes of determining the presence of a data race, operations on exception_Β­ptr objects shall access and modify only the exception_Β­ptr objects themselves and not the exceptions they refer to. Use of rethrow_Β­exception on exception_Β­ptr objects that refer to the same exception object shall not introduce a data race. [ Note: If rethrow_Β­exception rethrows the same exception object (rather than a copy), concurrent access to that rethrown exception object may introduce a data race. Changes in the number of exception_Β­ptr objects that refer to a particular exception do not introduce a data race.  — end note ]

exception_ptr current_exception() noexcept;

Returns: An exception_Β­ptr object that refers to the currently handled exception or a copy of the currently handled exception, or a null exception_Β­ptr object if no exception is being handled. The referenced object shall remain valid at least as long as there is an exception_Β­ptr object that refers to it. If the function needs to allocate memory and the attempt fails, it returns an exception_Β­ptr object that refers to an instance of bad_Β­alloc. It is unspecified whether the return values of two successive calls to current_Β­exception refer to the same exception object. [ Note: That is, it is unspecified whether current_Β­exception creates a new copy each time it is called.  — end note ] If the attempt to copy the current exception object throws an exception, the function returns an exception_Β­ptr object that refers to the thrown exception or, if this is not possible, to an instance of bad_Β­exception. [ Note: The copy constructor of the thrown exception may also fail, so the implementation is allowed to substitute a bad_Β­exception object to avoid infinite recursion. — end note ]

[[noreturn]] void rethrow_exception(exception_ptr p);

Requires: p shall not be a null pointer.

Throws: The exception object to which p refers.

template<class E> exception_ptr make_exception_ptr(E e) noexcept;

Effects: Creates an exception_Β­ptr object that refers to a copy of e, as if:

try {
  throw e;
} catch(...) {
  return current_exception();
}

[ Note: This function is provided for convenience and efficiency reasons.  — end note ]