std::exception

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica(C++20) Servicios del programa Apoyo de corrutinas(C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits(C++20) bitset hash (C++11) Operadores relacionales(en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Control de errores

Control de excepciones exception uncaught_exceptionuncaught_exceptions (hasta C++20)(C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Fallas del control de excepciones terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (hasta C++17) unexpected_handler (hasta C++17) get_unexpected (C++11)(hasta C++17) set_unexpected (hasta C++17) Códigos de error Códigos de error errno

Categorías de excepciones logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) Aserciones assert Facilidad system_error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11)

 

std::exception

Las funciones miembro Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

exception::exception

exception::~exception

exception::operator=

exception::what

 

Definido en el archivo de encabezado <exception>
class exception;

Proporciona una interfaz consistente para controlar los errores a través de la expresión throw.

Todas las excepciones generadas por la biblioteca estándar heredan de std::exception.

Todas las funciones miembro de std::exception son constexpr.

(desde C++26)

Funciones miembro

(constructor)	Construye el objeto excepción (función miembro pública)
(destructor) [virtual]	Destruye el objeto excepción. (función miembro virtual pública)
operator=	Copia el objeto excepción. (función miembro pública)
what [virtual]	Devuelve una cadena aclaratoria. (función miembro virtual pública)

Standard exception requirements

Cada clase de la biblioteca estándar T que se deriva de std::exception tiene las siguientes funciones miembro públicamente accesibles, cada una de ellas no egresan con una excepción(hasta C++11)tiene una especificación de excepción de no-lanzamiento(desde C++11):

• constructor por defecto (a menos que se suministren otros constructores),
• constructor de copia,
• operador de asignación de copia.

El constructor de copia y el operador de asignación de copia cumplen con la siguiente poscondición:

• Si dos objetos lhs y rhs tienen ambos tipo dinámico T y lhs es una copia de rhs, entonces std::strcmp(lhs.what(), rhs.what()) es igual a ​0​.

La función miembro what() de cada uno de estos T satisface las restricciones especificadas para std::exception::what().

Excepciones estándar

• logic_error

• invalid_argument
• domain_error
• length_error
• out_of_range
• future_error(desde C++11)

• runtime_error

• range_error
• overflow_error
• underflow_error
• regex_error(desde C++11)
• system_error(desde C++11)

• ios_base::failure(desde C++11)
• filesystem::filesystem_error(desde C++17)

• tx_exception(TM TS)
• nonexistent_local_time(desde C++20)
• ambiguous_local_time(desde C++20)
• format_error(desde C++20)

• bad_typeid
• bad_cast

• bad_any_cast(desde C++17)

• bad_optional_access(desde C++17)
• bad_expected_access(desde C++23)
• bad_weak_ptr(desde C++11)
• bad_function_call(desde C++11)
• bad_alloc

• bad_array_new_length(desde C++11)

• bad_exception
• ios_base::failure(hasta C++11)
• bad_variant_access(desde C++17)

Notas

Macro de prueba de característica
__cpp_lib_constexpr_exceptions	202411L	(C++26)	constexpr para los tipos excepción.

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 471	C++98	No existía un requisito en las clases de la biblioteca estándar derivadas de std::exception.	Se añadieron.