Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes