CKTIS / C++
std::invalid_argument — izjema za neveljaven argument
std::invalid_argument iz <stdexcept> sporoča neveljaven argument. Vsebuje diagnostično sporočilo, dostopno prek what(), in spada v hierarhijo izjem std::logic_error.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 vrsta izjeme iz <stdexcept>, namenjena sporočanju neveljavnega argumenta. Javno deduje iz std::logic_error in posredno iz std::exception.
Njena konstruktorja sprejemata sporočilo kot const std::string& ali const char*. Metoda what() omogoča dostop do besedila, ki se pri primerjavi kot niz C ujema s podanim sporočilom. Zgolj ustvarjanje objekta izjeme ne sproži: za njeno sporočanje uporabi throw.
V primeru require_name izrecno zavrne prazno ime. Blok catch prestreže izjemo prek const std::invalid_argument& in izpiše sporočilo. Preverjanje argumenta in odločitev za sprožitev izjeme sta del te funkcije, ne pa samodejno preverjanje, ki bi ga zagotavljala vrsta izjeme.
Ta vnos se nanaša na C++23. Navedeni vir je razvijajoči se osnutek standarda in prikazuje tudi konstruktorje constexpr; to ne dokazuje, da so v C++23 na voljo kot constexpr. Primer te uporabe ne zahteva. Zastavica prevajalnika ne potrjuje podpore v produkcijskem izvajalnem okolju.
Primeri
#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';
}
}
Rezultat
name must not be empty
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.