Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła