CKTIS / C++
std::invalid_argument — uitzondering voor ongeldig argument
std::invalid_argument uit <stdexcept> meldt een ongeldig argument. Het bevat een diagnosebericht dat beschikbaar is via what() en behoort tot de uitzonderingshiërarchie van std::logic_error.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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 is een uitzonderingstype uit <stdexcept> dat bedoeld is om een ongeldig argument te melden. Het leidt publiekelijk af van std::logic_error en indirect van std::exception.
De constructors accepteren een bericht als const std::string& of const char*. De methode what() geeft tekst terug die bij vergelijking als C-string overeenkomt met het opgegeven bericht. Alleen een object maken werpt het niet als uitzondering: gebruik throw om het te melden.
In het voorbeeld wijst require_name een lege naam expliciet af. Het catch-blok vangt de uitzondering op via const std::invalid_argument& en drukt het bericht af. Het controleren van het argument en beslissen om een uitzondering te werpen gebeurt in deze functie; het is geen automatische validatie door het uitzonderingstype.
Dit artikel betreft C++23. De opgegeven bron is een evoluerend concept van de standaard en toont ook constexpr-constructors; daaruit volgt niet dat deze in C++23 beschikbaar zijn als constexpr. Het voorbeeld vereist dit gebruik niet. Een compileroptie bevestigt geen ondersteuning in een productie-runtimeomgeving.
Voorbeelden
#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';
}
}
Resultaat
name must not be empty
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.