std::exception_ptr

 

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>
using exception_ptr = /*unspecified*/		(seit C++11)

std::exception_ptr ist ein nullfähiger zeigerähnlicher Typ, der ein Ausnahmeobjekt verwaltet, das mit std::current_exception geworfen und erfasst wurde. Eine Instanz von std::exception_ptr kann an eine andere Funktion übergeben werden, möglicherweise auf einem anderen Thread, wo die Ausnahme erneut geworfen und mit einer catch-Klausel behandelt werden kann.

Ein standardkonstruierter std::exception_ptr ist ein Nullzeiger; er zeigt auf kein Ausnahmeobjekt.

Zwei Instanzen von std::exception_ptr sind nur dann gleich, wenn beide null sind oder beide auf dasselbe Ausnahmeobjekt zeigen.

std::exception_ptr ist nicht implizit in irgendeinen arithmetischen, Aufzählungs- oder Zeigertyp konvertierbar. Er ist kontextbezogen in bool konvertierbar und ergibt false, wenn er null ist, andernfalls true.

Das von einem std::exception_ptr referenzierte Ausnahmeobjekt bleibt gültig, solange mindestens ein std::exception_ptr darauf verweist: std::exception_ptr ist ein Smart Pointer mit gemeinsamer Eigentümerschaft (Hinweis: Dies gilt zusätzlich zu den üblichen Lebensregeln für Ausnahmeobjekte).

std::exception_ptr erfüllt die Anforderungen von NullablePointer.

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

make_exception_ptr (C++11)	erstellt einen std::exception_ptr aus einem Ausnahmeobjekt (Funktionstemplate)
current_exception (C++11)	erfasst die aktuelle Ausnahme in einem std::exception_ptr (Funktion)
rethrow_exception (C++11)	wirft die Ausnahme aus einem std::exception_ptr (Funktion)