CKTIS / C++
std::out_of_range — wyjątek argumentu poza zakresem
std::out_of_range z nagłówka <stdexcept> sygnalizuje wartość argumentu poza oczekiwanym zakresem. Przenosi komunikat dostępny przez what() i dziedziczy po std::logic_error.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <stdexcept>
throw std::out_of_range("message");
// Handler:
catch (const std::out_of_range& e) { /* use e.what() */ }std::out_of_range to klasa wyjątku z nagłówka <stdexcept>, służąca do zgłaszania wartości argumentu poza oczekiwanym zakresem. Dziedziczy publicznie po std::logic_error, a pośrednio po std::exception.
Konstruktory przyjmują komunikat jako const std::string& albo const char*. Metoda what() udostępnia tekst zgodny z przekazanym komunikatem. Przechwytuj wyjątek przez const std::out_of_range&. Nie myl go z std::range_error, który opisuje błędy zakresu w obliczeniach wewnętrznych i dziedziczy po std::runtime_error.
W przykładzie checked_score jawnie sprawdza przedział [0, 100] i odrzuca 101. Samo istnienie klasy wyjątku nie dodaje sprawdzania zakresu do operacji. Przykład jest przeznaczony dla C++23; bieżący szkic standardu zawiera także późniejsze zmiany, więc pokazane tam konstruktory constexpr nie stanowią gwarancji dla C++23.
Przykłady
#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';
}
}
Wynik
score must be in [0, 100]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.