std::uncaught_exception, std::uncaught_exceptions

 

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>
	(1)
bool uncaught_exception() throw();			(bis C++11)
bool uncaught_exception() noexcept;			(seit C++11) (veraltet in C++17) (in C++20 entfernt)
int uncaught_exceptions() noexcept;		(2)	(seit C++17) (constexpr seit C++26)

1) Stellt fest, ob im aktuellen Thread ein aktives Ausnahmeobjekt vorhanden ist, d.h. eine Ausnahme wurde geworfen oder erneut geworfen und noch kein passender Catch-Block betreten, std::terminate oder std::unexpected. Mit anderen Worten, std::uncaught_exception stellt fest, ob Stack Unwinding gerade stattfindet.

2) Stellt fest, wie viele Ausnahmen im aktuellen Thread geworfen oder erneut geworfen wurden und noch nicht ihre passenden Catch-Blöcke betreten haben.

Manchmal ist es sicher, eine Ausnahme zu werfen, auch wenn std::uncaught_exception() = true(bis C++17) std::uncaught_exceptions() > 0(seit C++17). Zum Beispiel, wenn Stack Unwinding dazu führt, dass ein Objekt zerstört wird, könnte der Destruktor dieses Objekts Code ausführen, der eine Ausnahme wirft, solange die Ausnahme von einem Catch-Block abgefangen wird, bevor sie den Destruktor verlässt.

Parameter

(keine)

Rückgabewert

1) true, wenn Stack Unwinding in diesem Thread gerade stattfindet, andernfalls false.

2) Die Anzahl der nicht abgefangenen Ausnahmeobjekte im aktuellen Thread.

Hinweise

Ein Beispiel, in dem `uncaught_exceptions` mit Rückgabe eines `int` verwendet wird, ist die boost.log Bibliothek: Der Ausdruck BOOST_LOG(logger) << foo(); erstellt zuerst ein Guard-Objekt und speichert die Anzahl der nicht abgefangenen Ausnahmen in seinem Konstruktor. Die Ausgabe wird vom Destruktor des Guard-Objekts durchgeführt, es sei denn, `foo()` wirft eine Ausnahme (in diesem Fall ist die Anzahl der nicht abgefangenen Ausnahmen im Destruktor größer als die, die der Konstruktor beobachtet hat).

std::experimental::scope_fail und std::experimental::scope_success in LFTS v3 setzen auf die Funktionalität von `uncaught_exceptions`, da ihre Destruktoren unterschiedliche Dinge tun müssen, die davon abhängen, ob sie während des Stack Unwindings aufgerufen werden.

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_uncaught_exceptions	201411L	(C++17)	std::uncaught_exceptions
__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>
 
struct Foo
{
    char id{'?'};
    int count = std::uncaught_exceptions();
 
    ~Foo()
    {
        count == std::uncaught_exceptions()
            ? std::cout << id << ".~Foo() called normally\n"
            : std::cout << id << ".~Foo() called during stack unwinding\n";
    }
};
 
int main()
{
    Foo f{'f'};
 
    try
    {
        Foo g{'g'};
        std::cout << "Exception thrown\n";
        throw std::runtime_error("test exception");
    }
    catch (const std::exception& e)
    {
        std::cout << "Exception caught: " << e.what() << '\n';
    }
}

Mögliche Ausgabe

Exception thrown
g.~Foo() called during stack unwinding
Exception caught: test exception
f.~Foo() called normally

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 70	C++98	die Ausnahme-Spezifikation von `uncaught_exception()` fehlte	spezifiziert als `throw()`

Siehe auch

terminate	Funktion, die aufgerufen wird, wenn die Ausnahmebehandlung fehlschlägt (Funktion)
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)

Externe Links

1.	GOTW issue 47: Uncaught Exceptions
2.	Rationale for std::uncaught_exceptions (N4125)