CKTIS / C++
std::invalid_argument — výjimka pro neplatný argument
std::invalid_argument z <stdexcept> oznamuje neplatný argument. Obsahuje diagnostickou zprávu dostupnou přes what() a patří do hierarchie výjimek std::logic_error.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 je typ výjimky z <stdexcept> určený k oznámení neplatného argumentu. Veřejně dědí z std::logic_error a nepřímo z std::exception.
Jeho konstruktory přijímají zprávu jako const std::string& nebo const char*. Metoda what() zpřístupňuje text, který při porovnání jako řetězec C odpovídá předané zprávě. Pouhé vytvoření objektu tuto výjimku nevyvolá: k jejímu oznámení použijte throw.
V příkladu funkce require_name výslovně odmítne prázdné jméno. Blok catch zachytí výjimku prostřednictvím const std::invalid_argument& a vypíše zprávu. Kontrola argumentu a rozhodnutí vyvolat výjimku jsou součástí této funkce, nikoli automatickou validací zajišťovanou typem výjimky.
Tento záznam se vztahuje k C++23. Uvedený zdroj je vyvíjející se návrh standardu a ukazuje také konstruktory constexpr; z toho nelze vyvozovat, že jsou v C++23 dostupné jako constexpr. Příklad takové použití nevyžaduje. Příznak kompilátoru nepotvrzuje podporu v produkčním běhovém prostředí.
Příklady
#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';
}
}
Výsledek
name must not be empty
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.