std:: exception

Definiert im Header <exception>
class exception ;

Bietet eine konsistente Schnittstelle zur Fehlerbehandlung durch den throw expression .

Alle vom Standardbibliothek generierten Ausnahmen erben von std::exception .

Alle Memberfunktionen von std::exception sind constexpr .

(seit C++26)

Inhaltsverzeichnis 1 Memberfunktionen 2 Standard-Exception-Anforderungen 3 Standard-Exceptions 4 Anmerkungen 5 Fehlerberichte

Memberfunktionen

(constructor)	Konstruiert das Exception-Objekt (öffentliche Elementfunktion)
(destructor) [virtual]	Zerstört das Exception-Objekt (virtuelle öffentliche Elementfunktion)
operator=	Kopiert Exception-Objekt (öffentliche Elementfunktion)
what [virtual]	Gibt einen erläuternden String zurück (virtuelle öffentliche Elementfunktion)

Standardanforderungen für Ausnahmen

Jede Standardbibliotheksklasse T , die von std::exception abgeleitet ist, verfügt über die folgenden öffentlich zugänglichen Memberfunktionen, die jeweils nicht mit einer Exception beenden (bis C++11) eine nicht-werfende Exception-Spezifikation besitzen (seit C++11) :

• Default-Konstruktor (sofern keine anderen Konstruktoren bereitgestellt werden)
• Kopierkonstruktor
• Kopierzuweisungsoperator

Der Kopierkonstruktor und der Kopierzuweisungsoperator erfüllen die folgende Nachbedingung:

• Wenn zwei Objekte lhs und rhs beide den dynamischen Typ T haben und lhs eine Kopie von rhs ist, dann ist std:: strcmp ( lhs. what ( ) , rhs. what ( ) ) gleich ​ 0 ​ .

Die what() -Memberfunktion jedes solchen T erfüllt die für std::exception::what() spezifizierten Anforderungen.

Standardausnahmen

• logic_error

• invalid_argument
• domain_error
• length_error
• out_of_range

future_error

(seit C++11)

• runtime_error

• range_error
• overflow_error
• underflow_error

regex_error system_error ios_base::failure

(seit C++11)

filesystem::filesystem_error

(seit C++17)

tx_exception

(TM TS)

nonexistent_local_time ambiguous_local_time format_error

(seit C++20)

• bad_typeid
• bad_cast

bad_any_cast bad_optional_access

(seit C++17)

bad_expected_access

(seit C++23)

bad_weak_ptr bad_function_call

(seit C++11)

• bad_alloc

bad_array_new_length

(seit C++11)

• bad_exception

ios_base::failure

(bis C++11)

bad_variant_access

(seit C++17)

Hinweise

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

Fehlerberichte

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

DR	Angewendet auf	Verhalten wie veröffentlicht	Korrektes Verhalten
LWG 471	C++98	Es gab keine Anforderung an Standardbibliotheksklassen, die von std::exception abgeleitet sind	hinzugefügt