Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::out_of_range — argument mimo očakávaný rozsah

std::out_of_range, deklarovaný v <stdexcept>, oznamuje hodnotu argumentu mimo očakávaný rozsah. Nesie správu dostupnú cez what() a dedí z std::logic_error.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }

std::out_of_range je trieda výnimky deklarovaná v <stdexcept>, ktorá slúži na oznámenie hodnoty argumentu mimo očakávaného rozsahu. Verejne dedí z std::logic_error a nepriamo z std::exception.

Jej konštruktory prijímajú správu ako const std::string& alebo const char*. Člen what() sprístupňuje text zodpovedajúci zadanej správe. Výnimku zachytávajte ako const std::out_of_range&. Nezamieňajte si ju s std::range_error, ktorá opisuje chyby rozsahu pri interných výpočtoch a dedí z std::runtime_error.

V príklade checked_score výslovne kontroluje interval [0, 100] a odmieta 101. Samotná existencia tejto triedy výnimky nepridáva operáciám kontrolu rozsahu. Príklad je určený pre C++23; aktuálny pracovný návrh obsahuje aj neskoršie zmeny, preto uvedené konštruktory constexpr nie sú zárukou pre C++23.

Príklady

#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';
    }
}

Výsledok

score must be in [0, 100]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje