std::rethrow_exception

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

Выбрасывает ранее сохранённый объект исключения, на который указывает указатель исключения p, или копию этого объекта.

Не определено, будет ли создана копия. Если копия создаётся, память для неё выделяется неуказанным способом.

Поведение не определено, если p равен null.

Параметры

Исключения

Объект исключения, на который указывает p, если копия не создаётся.

В противном случае — копия такого объекта исключения, если реализации удалось скопировать объект исключения.

В противном случае — std::bad_alloc или исключение, выброшенное при копировании объекта исключения, если сбой произошёл соответственно при выделении памяти или копировании.

Примечания

До принятия P1675R2 функции rethrow_exception не разрешалось копировать объект исключения, что невозможно реализовать на некоторых платформах, где объекты исключений выделяются в стеке.

Пример

#include <exception>
#include <iostream>
#include <stdexcept>
#include <string>

void handle_eptr(std::exception_ptr eptr) // passing by value is OK
{
    try
    {
        if (eptr)
            std::rethrow_exception(eptr);
    }
    catch(const std::exception& e)
    {
        std::cout << "Caught exception: '" << e.what() << "'\n";
    }
}

int main()
{
    std::exception_ptr eptr;

    try
    {
        [[maybe_unused]]
        char ch = std::string().at(1); // this generates a std::out_of_range
    }
    catch(...)
    {
        eptr = std::current_exception(); // capture
    }

    handle_eptr(eptr);

} // destructor for std::out_of_range called here, when the eptr is destructed

Caught exception: 'basic_string::at: __n (which is 1) >= this->size() (which is 0)'

См. также