Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri