CKTIS / C++
std::out_of_range — argument izvan očekivanog raspona
std::out_of_range, deklariran u <stdexcept>, označava vrijednost argumenta izvan očekivanog raspona. Sadrži poruku dostupnu putem what() i nasljeđuje std::logic_error.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }std::out_of_range klasa je iznimke deklarirana u <stdexcept> za označavanje vrijednosti argumenta izvan očekivanog raspona. Javno nasljeđuje std::logic_error, a posredno i std::exception.
Njezini konstruktori prihvaćaju poruku kao const std::string& ili const char*. Član what() daje tekst koji odgovara zadanoj poruci. Iznimku uhvatite kao const std::out_of_range&. Nemojte je zamijeniti s std::range_error, koja opisuje pogreške raspona u internim izračunima i nasljeđuje std::runtime_error.
U primjeru checked_score izričito provjerava interval [0, 100] i odbacuje 101. Postojanje ove klase iznimke ne dodaje provjeru raspona operacijama. Primjer je namijenjen za C++23; trenutačni radni nacrt uključuje i kasnije promjene, pa konstruktori constexpr prikazani u njemu nisu jamstvo za C++23.
Primjeri
#include <iostream>
#include <stdexcept>
int checked_score(int score) {
if (score < 0 || score > 100) {
throw std::out_of_range("score must be in [0, 100]");
}
return score;
}
int main() {
try {
std::cout << checked_score(101) << '\n';
} catch (const std::out_of_range& e) {
std::cout << e.what() << '\n';
}
}
Rezultat
score must be in [0, 100]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.