Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::invalid_argument — exceção de argumento inválido

std::invalid_argument de <stdexcept> assinala um argumento inválido. Contém uma mensagem de diagnóstico acessível através de what() e pertence à hierarquia de exceções de std::logic_error.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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 é um tipo de exceção de <stdexcept> destinado a assinalar um argumento inválido. Deriva publicamente de std::logic_error e, indiretamente, de std::exception.

Os seus construtores aceitam uma mensagem como const std::string& ou const char*. O método what() disponibiliza texto que corresponde à mensagem fornecida quando comparado como cadeia C. A simples criação de um objeto não o lança como exceção: utiliza throw para o assinalar.

No exemplo, require_name rejeita explicitamente um nome vazio. O bloco catch captura a exceção através de const std::invalid_argument& e apresenta a mensagem. A verificação do argumento e a decisão de lançar uma exceção são da responsabilidade desta função; não são uma validação automática fornecida pelo tipo de exceção.

Esta entrada diz respeito a C++23. A fonte fornecida é um projeto de norma em evolução e também apresenta construtores constexpr; isso não demonstra que estejam disponíveis como constexpr em C++23. O exemplo não necessita dessa utilização. Uma opção do compilador não atesta o suporte num ambiente de execução de produção.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes