Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje