Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::invalid_argument — wyjątek nieprawidłowego argumentu

std::invalid_argument z nagłówka <stdexcept> służy do zgłaszania nieprawidłowego argumentu. Pozwala przekazać komunikat dostępny przez what() i należy do hierarchii std::logic_error.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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 jest typem wyjątku z nagłówka <stdexcept>, przeznaczonym do zgłaszania nieprawidłowego argumentu. Dziedziczy publicznie po std::logic_error, a pośrednio po std::exception.

Konstruktory przyjmują komunikat jako const std::string& albo const char*. Metoda what() udostępnia tekst zgodny z przekazanym komunikatem w sensie porównania łańcuchów C. Samo utworzenie obiektu nie rzuca go jako wyjątku: do zgłoszenia użyj throw.

W przykładzie require_name jawnie odrzuca pustą nazwę. Blok catch przechwytuje wyjątek przez const std::invalid_argument&, a następnie wypisuje komunikat. Sprawdzenie argumentu i decyzja o rzuceniu wyjątku są częścią tej funkcji, a nie automatyczną kontrolą zapewnianą przez typ wyjątku.

Zakres wpisu to C++23. Podane źródło jest rozwijanym szkicem standardu i pokazuje również konstruktory constexpr; nie należy z tego wnioskować o ich dostępności jako constexpr w C++23. Przykład nie wymaga takiego użycia. Flaga kompilatora nie potwierdza obsługi w produkcyjnym środowisku wykonawczym.

Przykłady

#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';
    }
}

Wynik

name must not be empty

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła