std::rethrow_exception

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Diagnostik-Bibliothek

Ausnahmebehandlung exception uncaught_exceptionuncaught_exceptions (bis C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (bis C++17*) unexpected_handler (bis C++17*) get_unexpected (bis C++17*) set_unexpected (bis C++17*) Fehlernummern Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging-Unterstützung is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

Definiert in Header <exception>
[[noreturn]] void rethrow_exception( std::exception_ptr p );		(seit C++11) (constexpr seit C++26)

Wirft das zuvor erfasste Ausnahmeobjekt, auf das durch den Ausnahmezeiger p verwiesen wird, oder eine Kopie dieses Objekts.

Es ist nicht spezifiziert, ob eine Kopie erstellt wird. Wenn eine Kopie erstellt wird, wird der Speicher dafür auf nicht spezifizierte Weise zugewiesen.

Das Verhalten ist undefiniert, wenn p null ist.

Parameter

p

-

nicht-null std::exception_ptr

Ausnahmen

Das Ausnahmeobjekt, auf das von p verwiesen wird, wenn keine Kopie erstellt wird.

Andernfalls eine Kopie eines solchen Ausnahmeobjekts, wenn die Implementierung das Ausnahmeobjekt erfolgreich kopiert hat.

Andernfalls std::bad_alloc oder die Ausnahme, die beim Kopieren des Ausnahmeobjekts ausgelöst wird, wenn die Zuweisung oder das Kopieren fehlschlägt.

Hinweise

Vor P1675R2 durfte rethrow_exception das Ausnahmeobjekt nicht kopieren, was auf einigen Plattformen, auf denen Ausnahmeobjekte auf dem Stack zugewiesen werden, nicht implementierbar war.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_constexpr_exceptions	202411L	(C++26)	constexpr für Ausnahme-Typen

Beispiel

Führen Sie diesen Code aus

#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

Mögliche Ausgabe

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

Siehe auch

exception_ptr (C++11)	Shared-Pointer-Typ zur Handhabung von Ausnahmeobjekten (Typedef)
current_exception (C++11)	erfasst die aktuelle Ausnahme in einem std::exception_ptr (Funktion)