std::bad_cast
| Определён в заголовке <typeinfo>
|
||
class bad_cast : public std::exception;
|
||
Исключение этого типа выбрасывается, когда dynamic_cast к ссылочному типу не проходит проверку во время выполнения (например, потому что типы не связаны наследованием), а также из std::use_facet, если запрошенный аспект (facet) не существует в локали.
Диаграмма наследования
Функции-члены
|
(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()
.
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) | |
Присваивает содержимое объекта 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