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.