Namespaces
Variants

std::bad_cast

Von de.cppreference.net
 
 
Dienstprogrammbibliothek
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Feature-Test-Makros der Bibliothek (C++20)
Programm-Dienstprogramme
Variadische Funktionen
Koroutinenunterstützung (C++20)
Vertragsunterstützung (C++26)
Dreiseitiger Vergleich
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Allgemeine Dienstprogramme
Relationale Operatoren (veraltet in C++20)
Ganzzahl-Vergleichsfunktionen
(C++20)(C++20)(C++20)    
(C++20)
Swap und Typoperationen
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Allgemeine Vokabular-Typen
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
 
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.

cpp/error/exception

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.

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)

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