CKTIS / C++
std::invalid_argument — výnimka pre neplatný argument
std::invalid_argument z <stdexcept> oznamuje neplatný argument. Obsahuje diagnostickú správu dostupnú cez what() a patrí do hierarchie výnimiek std::logic_error.
Verzia: 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 je typ výnimky z <stdexcept> určený na oznámenie neplatného argumentu. Verejne dedí z std::logic_error a nepriamo z std::exception.
Jeho konštruktory prijímajú správu ako const std::string& alebo const char*. Metóda what() sprístupňuje text, ktorý pri porovnaní ako reťazec C zodpovedá zadanej správe. Samotné vytvorenie objektu túto výnimku nevyvolá: na jej oznámenie použite throw.
V príklade funkcia require_name výslovne odmietne prázdne meno. Blok catch zachytí výnimku prostredníctvom const std::invalid_argument& a vypíše správu. Kontrola argumentu a rozhodnutie vyvolať výnimku patria do tejto funkcie; nejde o automatickú validáciu zabezpečenú typom výnimky.
Tento záznam sa týka C++23. Uvedený zdroj je vyvíjajúci sa návrh štandardu a uvádza aj konštruktory constexpr; z toho nemožno vyvodzovať, že sú v C++23 dostupné ako constexpr. Príklad takéto použitie nevyžaduje. Príznak kompilátora nepotvrdzuje podporu v produkčnom runtime prostredí.
Prí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ýsledok
name must not be empty
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.