CKTIS / C++
std::invalid_argument — excepción por argumento no válido
std::invalid_argument, de <stdexcept>, informa de un argumento no válido. Contiene un mensaje de diagnóstico accesible mediante what() y forma parte de la jerarquía de excepciones de std::logic_error.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdexcept>
// C++23 constructors:
explicit invalid_argument(const std::string& what_arg);
explicit invalid_argument(const char* what_arg);
throw std::invalid_argument("message");std::invalid_argument es un tipo de excepción de <stdexcept> destinado a informar de un argumento no válido. Hereda públicamente de std::logic_error e indirectamente de std::exception.
Sus constructores aceptan un mensaje como const std::string& o const char*. El método what() proporciona un texto que coincide con el mensaje suministrado al compararlo como cadena C. Crear un objeto por sí solo no lo lanza como excepción: usa throw para notificarlo.
En el ejemplo, require_name rechaza explícitamente un nombre vacío. El bloque catch captura la excepción mediante const std::invalid_argument& y muestra el mensaje. Comprobar el argumento y decidir si se lanza una excepción son tareas de esta función, no una validación automática proporcionada por el tipo de excepción.
Esta entrada se refiere a C++23. La fuente proporcionada es un borrador evolutivo del estándar y también muestra constructores constexpr; esto no demuestra que estén disponibles como constexpr en C++23. El ejemplo no necesita ese uso. Una opción del compilador no acredita el soporte en un entorno de ejecución de producción.
Ejemplos
#include <iostream>
#include <stdexcept>
#include <string>
void require_name(const std::string& name) {
if (name.empty()) {
throw std::invalid_argument("name must not be empty");
}
}
int main() {
try {
require_name("");
} catch (const std::invalid_argument& error) {
std::cout << error.what() << '\n';
}
}
Resultado
name must not be empty
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.