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.