Namespaces
Variants

std:: bad_cast

From cppreference.net
C++
Utilities library
Type support
Definiert im Header <typeinfo>
class bad_cast : public std:: exception

Eine Ausnahme dieses Typs wird ausgelöst, wenn eine dynamic_cast zu einem Referenztyp die Laufzeitprüfung nicht besteht (z.B. weil die Typen nicht durch Vererbung verbunden sind), und ebenfalls von std::use_facet wenn die angeforderte Facette im Locale nicht vorhanden ist.

cpp/error/exception std-bad cast-inheritance.svg

Vererbungsdiagramm

Inhaltsverzeichnis

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.

1) Standardkonstruktor.
2) Kopierkonstruktor. Wenn * this und other beide den dynamischen Typ 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)
(constexpr seit C++26)

Weist die Inhalte mit denen von other zu. Wenn * this und other beide den dynamischen Typ std::bad_cast haben, dann gilt 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 den erklärenden String 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

Diesen Code ausführen 
#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