std::format_error

 

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)

 

Biblioteca de formato

Funciones de formato

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

Formateador

formatter (C++20)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

Argumentos de formato

basic_format_arg (C++20)

basic_format_argsformat_argswformat_argsformat_args_t (C++20)(C++20)(C++20)(C++20)

visit_format_arg (C++20)

make_format_argsmake_wformat_args (C++20)(C++20)

Error de formato

format_error (C++20)

 

Definido en el archivo de encabezado <format>
class format_error;		(desde C++20)

Define el tipo de objeto excepción lanzado para reportar errores en la biblioteca de formato.

Inheritance diagram

Funciones miembro

(constructor)	Construye un nuevo objeto format_error con el mensaje dado. (función miembro pública)
operator=	Reemplaza el objeto format_error. (función miembro pública)
what	Devuelve la cadena aclaratoria. (función miembro pública)

std::format_error::format_error

format_error(conststd::string& what_arg );	(1)	(desde C++20)
format_error(constchar* what_arg );	(2)	(desde C++20)
format_error(const format_error& other )noexcept;	(3)	(desde C++20)

1-2) Construye el objeto excepción con what_arg como la cadena aclaratoria que puede accederse mediante what().

3) Constructor de copia. Si tanto *this como other tienen el tipo dinámico std::format_error , entonces std::strcmp(what(), other.what())==0.

Parámetros

what_arg	-	Cadena aclaratoria.
other	-	Otro objeto excepción a copiar.

Excepciones

1-2) Puede lanzar std::bad_alloc.

Notas

Como no se permite que se lancen excepciones al copiar a std::format_error, este mensaje típicamente se almacena internamente como una cadena cuya memoria se asigna de manera separada, y con conteo de referencias. También esta es la razon por la que no existe un constructor que tome un std::string&&: tendría que copiarse el contenido de todas formas.

std::format_error::operator=

format_error& operator=(const format_error& other )noexcept;		(desde C++20)

Asigna el contenido con el de other. Si tanto *this como other tienen el tipo dinámico std::format_error, entonces std::strcmp(what(), other.what())==0 después de la asignación.

Parámetros

other

-

Otro objeto excepción con el cual asignar.

Valor de retorno

*this

std::format_error::what

virtualconstchar* what()constnoexcept;		(desde C++20)

Devuelve la cadena aclaratoria.

Parámetros

(Ninguno)

Valor de retorno

Un puntero a una cadena terminada en nulo con información aclaratoria. La cadena es adecuada para convertirse y mostrarse como un std::wstring. Se garantiza que el puntero sea válido al menos hasta que el objeto excepción del cual se obtuvo se destruya, o hasta que una función miembro no const (p. ej., el operador de asignación de copia) se llame en el objeto excepción.

Notas

Se permite, pero no se requiere, que las implementaciones redefinan a what().

Heredado de std::runtime_error

Heredado de std::exception

Funciones miembro

(destructor) [virtual]	Destruye el objeto excepción. (función miembro virtual pública de std::exception)
what [virtual]	Devuelve una cadena aclaratoria. (función miembro virtual pública de std::exception)