std::bad_cast
| Definiert in Header <typeinfo>
|
||
class bad_cast : public std::exception;
|
||
Eine Ausnahme dieses Typs wird ausgelöst, wenn eine dynamic_cast auf einen Referenztyp die Laufzeitprüfung nicht besteht (z. B. weil die Typen nicht durch Vererbung verwandt sind), und auch von std::use_facet, wenn das angeforderte Facet im Gebietsschema nicht vorhanden ist.
Vererbungsdiagramm
Memberfunktionen
|
(Konstruktor)
|
konstruiert ein neues
bad_cast
Objekt
(öffentliche Elementfunktion) |
|
operator=
|
ersetzt das
bad_cast
Objekt
(öffentliche Elementfunktion) |
|
what
|
gibt die erklärende Zeichenkette zurück
(öffentliche Elementfunktion) |
std::bad_cast:: bad_cast
| (1) | ||
|
bad_cast
(
)
throw
(
)
;
|
(bis C++11) | |
|
bad_cast
(
)
noexcept
;
|
(seit C++11)
(constexpr seit C++26) |
|
| (2) | ||
|
bad_cast
(
const
bad_cast
&
other
)
throw
(
)
;
|
(bis C++11) | |
|
bad_cast
(
const
bad_cast
&
other
)
noexcept
;
|
(seit C++11)
(constexpr seit C++26) |
|
Konstruiert ein neues
bad_cast
-Objekt mit einer implementierungsdefinierten nullterminierten Byte-Zeichenkette, die über
what()
zugänglich ist.
std::bad_cast
haben, dann gilt
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
.
(seit C++11)
Parameter
| other | - | ein weiteres Ausnahmeobjekt zum Kopieren |
std::bad_cast::operator=
bad_cast& operator=( const bad_cast& other ) throw();
|
(bis C++11) | |
bad_cast& operator=( const bad_cast& other ) noexcept;
|
(seit C++11) | |
Weist die Inhalte von other zu. Falls *this und other beide den dynamischen Typ std::bad_cast haben, dann std::strcmp(what(), other.what()) == 0 nach der Zuweisung.(seit C++11)
Parameter
| other | - | ein weiteres Ausnahmeobjekt, mit dem zugewiesen wird |
Rückgabewert
* this
std::bad_cast::what
virtual const char* what() const throw();
|
(bis C++11) | |
virtual const char* what() const noexcept;
|
(seit C++11) (constexpr seit C++26) |
|
Gibt die erklärende Zeichenkette zurück.
Rückgabewert
Zeiger auf einen implementierungsdefinierten nullterminierten String mit erklärenden Informationen. Der String ist geeignet für Konvertierung und Anzeige als std::wstring . Der Zeiger ist garantiert mindestens so lange gültig, bis das Ausnahmeobjekt, von dem er erhalten wurde, zerstört wird, oder bis eine nicht-konstante Memberfunktion (z.B. Kopierzuweisungsoperator) auf dem Ausnahmeobjekt aufgerufen wird.
|
Der zurückgegebene String wird während der Konstantenauswertung mit der gewöhnlichen Literalkodierung kodiert. |
(seit C++26) |
Anmerkungen
Implementierungen dürfen, müssen aber nicht,
what()
überschreiben.
Geerbt von std:: exception
Elementfunktionen
|
[virtual]
|
zerstört das Ausnahmeobjekt
(virtuelle öffentliche Elementfunktion von
std::exception
)
|
|
[virtual]
|
gibt einen erläuternden String zurück
(virtuelle öffentliche Elementfunktion von
std::exception
)
|
Hinweise
| Feature-Test Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_constexpr_exceptions
|
202411L
|
(C++26) | constexpr für Ausnahmetypen |
Beispiel
#include <iostream> #include <typeinfo> struct Foo { virtual ~Foo() {} }; struct Bar { virtual ~Bar() { std::cout << "~Bar\n"; } }; struct Pub : Bar { ~Pub() override { std::cout << "~Pub\n"; } }; int main() { Pub pub; try { [[maybe_unused]] Bar& r1 = dynamic_cast<Bar&>(pub); // OK, Upcast [[maybe_unused]] Foo& r2 = dynamic_cast<Foo&>(pub); // wirft Exception } catch (const std::bad_cast& e) { std::cout << "e.what(): " << e.what() << '\n'; } }
Mögliche Ausgabe:
e.what(): std::bad_cast ~Pub ~Bar