Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

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

std::out_of_range, deklarovaný v <stdexcept>, oznamuje hodnotu argumentu mimo očekávaný rozsah. Nese zprávu dostupnou přes what() a dědí z std::logic_error.

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

Syntaxe

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

std::out_of_range je třída výjimky deklarovaná v <stdexcept>, která slouží k oznámení hodnoty argumentu mimo očekávaný rozsah. Veřejně dědí z std::logic_error a nepřímo z std::exception.

Její konstruktory přijímají zprávu jako const std::string& nebo const char*. Člen what() zpřístupňuje text odpovídající předané zprávě. Výjimku zachytávejte jako const std::out_of_range&. Nezaměňujte ji s std::range_error, která popisuje chyby rozsahu při interních výpočtech a dědí z std::runtime_error.

V příkladu checked_score výslovně kontroluje interval [0, 100] a odmítá 101. Samotná existence této třídy výjimky nepřidává operacím kontrolu rozsahu. Příklad cílí na C++23; aktuální pracovní návrh obsahuje také pozdější změny, takže uvedené konstruktory constexpr nejsou zárukou pro C++23.

Pří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ýsledek

score must be in [0, 100]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje