Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje