std::current_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>
std::exception_ptr current_exception() noexcept;		(seit C++11) (constexpr seit C++26)

Wenn während der Ausnahmebehandlung (typischerweise in einer catch-Klausel) aufgerufen, erfasst das aktuelle Ausnahmeobjekt und erstellt einen std::exception_ptr, der entweder eine Kopie oder eine Referenz auf dieses Ausnahmeobjekt enthält (abhängig von der Implementierung). Das referenzierte Objekt bleibt mindestens so lange gültig, wie ein exception_ptr-Objekt darauf verweist.

Wenn die Implementierung dieser Funktion einen Aufruf von new erfordert und der Aufruf fehlschlägt, enthält der zurückgegebene Zeiger eine Referenz auf eine Instanz von std::bad_alloc.

Wenn die Implementierung dieser Funktion das Kopieren des erfassten Ausnahmeobjekts erfordert und sein Kopierkonstruktor eine Ausnahme auslöst, enthält der zurückgegebene Zeiger eine Referenz auf die ausgelöste Ausnahme. Wenn der Kopierkonstruktor des ausgelösten Ausnahmeobjekts ebenfalls eine Ausnahme auslöst, kann der zurückgegebene Zeiger eine Referenz auf eine Instanz von std::bad_exception enthalten, um die Endlosschleife zu unterbrechen.

Wenn die Funktion aufgerufen wird, während keine Ausnahme behandelt wird, wird ein leerer std::exception_ptr zurückgegeben.

Diese Funktion kann in einem std::terminate_handler aufgerufen werden, um die Ausnahme abzurufen, die die Ausführung von std::terminate ausgelöst hat.

Rückgabewert

Eine Instanz von std::exception_ptr, die eine Referenz auf das Ausnahmeobjekt, eine Kopie des Ausnahmeobjekts oder eine Referenz auf eine Instanz von std::bad_alloc oder eine Instanz von std::bad_exception enthält.

Hinweise

Bei Implementierungen, die dem Itanium C++ ABI folgen (GCC, Clang etc.), werden Ausnahmen beim Werfen auf dem Heap alloziert (außer bei std::bad_alloc in einigen Fällen), und diese Funktion erstellt einfach den Smart Pointer, der auf das zuvor alloziierte Objekt verweist. Bei MSVC werden Ausnahmen beim Werfen auf dem Stack alloziert, und diese Funktion führt die Heap-Allokation durch und kopiert das Ausnahmeobjekt.

Unter Windows in verwalteten CLR-Umgebungen [1] speichert die Implementierung eine std::bad_exception, wenn die aktuelle Ausnahme eine verwaltete Ausnahme ist ([2]). Beachten Sie, dass catch(...) auch verwaltete Ausnahmen abfängt.

#include <exception>
 
int main()
{
    try
    {
        throw gcnew System::Exception("Managed exception");
    }
    catch (...)
    {
        std::exception_ptr ex = std::current_exception();
        try
        {
            std::rethrow_exception(ex);
        }
        catch (std::bad_exception const &)
        {
            // This will be printed.
            std::cout << "Bad exception" << std::endl;
        }
    }
}

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)
rethrow_exception (C++11)	wirft die Ausnahme aus einem std::exception_ptr (Funktion)
make_exception_ptr (C++11)	erstellt einen std::exception_ptr aus einem Ausnahmeobjekt (Funktionstemplate)
uncaught_exceptionuncaught_exceptions (in C++20* entfernt)(C++17)	prüft, ob gerade eine Ausnahmebehandlung im Gange ist (Funktion)