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.