Namespaces
Variants

std:: bad_cast

From cppreference.net
C++
Utilities library
Type support
Определено в заголовочном файле <typeinfo>
class bad_cast : public std:: exception

Исключение этого типа выбрасывается, когда dynamic_cast к ссылочному типу не проходит проверку во время выполнения (например, потому что типы не связаны наследованием), а также из std::use_facet если запрашиваемый фасет отсутствует в локали.

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

Диаграмма наследования

Содержание

Функции-члены

(constructor)
создает новый объект bad_cast
(public member function)
operator=
заменяет объект bad_cast
(public member function)
what
возвращает поясняющую строку
(public member function)

std::bad_cast:: bad_cast

(1)
bad_cast ( ) throw ( ) ;
(до C++11)
bad_cast ( ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)
(2)
bad_cast ( const bad_cast & other ) throw ( ) ;
(до C++11)
bad_cast ( const bad_cast & other ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Создает новый объект bad_cast с определенной реализацией нуль-терминированной строкой байтов, доступной через what() .

1) Конструктор по умолчанию.
2) Конструктор копирования. Если * this и other оба имеют динамический тип std::bad_cast , то std:: strcmp ( what ( ) , other. what ( ) ) == 0 . (начиная с C++11)

Параметры

other - другой объект исключения для копирования

std::bad_cast:: operator=

bad_cast & operator = ( const bad_cast & other ) throw ( ) ;
(до C++11)
bad_cast & operator = ( const bad_cast & other ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Присваивает содержимое из объекта other . Если * this и other оба имеют динамический тип std::bad_cast , то после присваивания std:: strcmp ( what ( ) , other. what ( ) ) == 0 . (начиная с C++11)

Параметры

other - другой объект исключения для присваивания

Возвращаемое значение

* this

std::bad_cast:: what

virtual const char * what ( ) const throw ( ) ;
(до C++11)
virtual const char * what ( ) const noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Возвращает пояснительную строку.

Возвращаемое значение

Указатель на определенную реализацией нуль-терминированную строку с пояснительной информацией. Строка подходит для преобразования и отображения как std::wstring . Гарантируется, что указатель остается действительным по крайней мере до тех пор, пока не будет уничтожен объект исключения, из которого он получен, или пока не будет вызвана неконстантная функция-член (например, оператор присваивания копированием) для объекта исключения.

Возвращаемая строка кодируется с использованием обычного литерального кодирования во время константной оценки.

(начиная с C++26)

Примечания

Реализациям разрешено, но не требуется, переопределять what() .

Унаследовано от std:: exception

Функции-члены

[virtual]
уничтожает объект исключения
(виртуальная публичная функция-член std::exception )
[virtual]
возвращает пояснительную строку
(виртуальная публичная функция-член std::exception )

Примечания

Макрос тестирования возможностей Значение Стандарт Функция
__cpp_lib_constexpr_exceptions 202411L (C++26) constexpr для типов исключений

Пример

Запустить этот код 
#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); // throws
    }
    catch (const std::bad_cast& e)
    {
        std::cout << "e.what(): " << e.what() << '\n';
    }
}

Возможный вывод: 

e.what(): std::bad_cast
~Pub
~Bar