CKTIS / C++
std::invalid_argument — eccezione per argomento non valido
std::invalid_argument di <stdexcept> segnala un argomento non valido. Contiene un messaggio diagnostico accessibile tramite what() e appartiene alla gerarchia di eccezioni di std::logic_error.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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 è un tipo di eccezione di <stdexcept> destinato a segnalare un argomento non valido. Deriva pubblicamente da std::logic_error e, indirettamente, da std::exception.
I suoi costruttori accettano un messaggio come const std::string& oppure const char*. Il metodo what() rende disponibile un testo che, confrontato come stringa C, corrisponde al messaggio fornito. La semplice creazione di un oggetto non lo genera come eccezione: usa throw per segnalarlo.
Nell’esempio, require_name rifiuta esplicitamente un nome vuoto. Il blocco catch intercetta l’eccezione tramite const std::invalid_argument& e stampa il messaggio. Il controllo dell’argomento e la decisione di generare un’eccezione spettano a questa funzione; non sono una convalida automatica fornita dal tipo di eccezione.
Questa voce riguarda C++23. La fonte fornita è una bozza in evoluzione dello standard e mostra anche costruttori constexpr; ciò non dimostra che siano disponibili come constexpr in C++23. L’esempio non richiede tale uso. Un’opzione del compilatore non attesta il supporto nell’ambiente di esecuzione di produzione.
Esempi
#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';
}
}
Risultato
name must not be empty
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.