Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori