CKTIS / C++
std::format_error — excepción por error de formato
std::format_error, declarado en <format>, señala errores de la biblioteca de formato. Aprende a distinguir una excepción en tiempo de ejecución del rechazo en compilación de una cadena de formato no válida y a capturar esta excepción de forma segura.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <format>
// C++23 constructor signatures:
// std::format_error publicly derives from std::runtime_error.
explicit format_error(const std::string& what_arg);
explicit format_error(const char* what_arg);
// Catch by const reference:
catch (const std::format_error& e) { /* handle formatting error */ }std::format_error es una clase de excepción declarada en <format> que deriva públicamente de std::runtime_error. Señala errores de la biblioteca de formato. Captúrala como const std::format_error& para evitar copiar el objeto y conservar el acceso a su mensaje de diagnóstico mediante what().
Sus dos constructores explícitos aceptan const std::string& o const char*. Para una excepción que crees tú, what() devuelve un texto que coincide con la cadena terminada en nulo proporcionada. Sin embargo, no des por sentado un texto de diagnóstico concreto para las excepciones generadas por la biblioteca; el ejemplo imprime un mensaje fijo propio.
En C++23, un literal no válido pasado a std::format, como std::format("{:d}", "hello"), provoca un error de compilación, no una excepción que se pueda capturar. Usa std::vformat con std::make_format_args para un patrón disponible en tiempo de ejecución. En el ejemplo, {:d} requiere un entero, pero el argumento es una cadena, por lo que se lanza std::format_error. El argumento value permanece vivo durante toda la llamada.
No todas las excepciones de formato son std::format_error: las excepciones de los formateadores y los iteradores se propagan, mientras que los errores de asignación se notifican por separado. El borrador de trabajo citado evoluciona y también muestra cambios posteriores a C++23; la sintaxis indicada no marca los constructores como constexpr. Una opción de compilador C++23 en el repositorio no acredita que la biblioteca sea compatible en el entorno de producción.
Ejemplos
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{:d}";
std::string value = "hello";
try {
std::cout << std::vformat(pattern, std::make_format_args(value)) << '\n';
} catch (const std::format_error&) {
std::cout << "format_error caught\n";
return 0;
}
return 1;
}
Resultado
format_error caught
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.