std:: bad_cast
|
Definido en el encabezado
<typeinfo>
|
||
|
class
bad_cast
:
public
std::
exception
|
||
Se lanza una excepción de este tipo cuando un dynamic_cast a un tipo de referencia falla la verificación en tiempo de ejecución (por ejemplo, porque los tipos no están relacionados por herencia), y también desde std::use_facet si la faceta solicitada no existe en la configuración regional.
Diagrama de herencia
Contenidos |
Funciones miembro
|
(constructor)
|
construye un nuevo objeto
bad_cast
(función miembro pública) |
|
operator=
|
reemplaza el objeto
bad_cast
(función miembro pública) |
|
what
|
devuelve la cadena explicativa
(función miembro pública) |
std::bad_cast:: bad_cast
| (1) | ||
|
bad_cast
(
)
throw
(
)
;
|
(hasta C++11) | |
|
bad_cast
(
)
noexcept
;
|
(desde C++11)
(constexpr desde C++26) |
|
| (2) | ||
|
bad_cast
(
const
bad_cast
&
other
)
throw
(
)
;
|
(hasta C++11) | |
|
bad_cast
(
const
bad_cast
&
other
)
noexcept
;
|
(desde C++11)
(constexpr desde C++26) |
|
Construye un nuevo objeto
bad_cast
con una cadena de bytes terminada en nulo definida por la implementación que es accesible a través de
what()
.
std::bad_cast
entonces
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
.
(desde C++11)
Parámetros
| other | - | otro objeto de excepción a copiar |
std::bad_cast:: operator=
|
bad_cast
&
operator
=
(
const
bad_cast
&
other
)
throw
(
)
;
|
(hasta C++11) | |
|
bad_cast
&
operator
=
(
const
bad_cast
&
other
)
noexcept
;
|
(desde C++11)
(constexpr desde C++26) |
|
Asigna los contenidos con los de
other
.
Si
*
this
y
other
ambos tienen tipo dinámico
std::bad_cast
entonces
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
después de la asignación.
(desde C++11)
Parámetros
| other | - | otro objeto de excepción con el cual asignar |
Valor de retorno
* this
std::bad_cast:: what
|
virtual
const
char
*
what
(
)
const
throw
(
)
;
|
(hasta C++11) | |
|
virtual
const
char
*
what
(
)
const
noexcept
;
|
(desde C++11)
(constexpr desde C++26) |
|
Devuelve la cadena explicativa.
Valor de retorno
Puntero a una cadena terminada en nulo definida por la implementación con información explicativa. La cadena es adecuada para conversión y visualización como std::wstring . Se garantiza que el puntero será válido al menos hasta que se destruya el objeto de excepción del cual se obtiene, o hasta que se llame a una función miembro no constante (por ejemplo, el operador de asignación de copia) en el objeto de excepción.
|
La cadena devuelta está codificada con la codificación literal ordinaria durante la evaluación constante. |
(desde C++26) |
Notas
Se permite a las implementaciones, pero no se requiere, sobrescribir
what()
.
Heredado de std:: exception
Funciones miembro
|
[virtual]
|
destruye el objeto de excepción
(función miembro pública virtual de
std::exception
)
|
|
[virtual]
|
devuelve una cadena explicativa
(función miembro pública virtual de
std::exception
)
|
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_constexpr_exceptions
|
202411L
|
(C++26) | constexpr para tipos de excepción |
Ejemplo
#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'; } }
Salida posible:
e.what(): std::bad_cast ~Pub ~Bar