База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::out_of_range — аргумент извън очаквания диапазон

std::out_of_range, деклариран в <stdexcept>, сигнализира за стойност на аргумент извън очаквания диапазон. Съдържа съобщение, достъпно чрез what(), и наследява std::logic_error.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

std::out_of_range е клас на изключение, деклариран в <stdexcept>, за сигнализиране на стойност на аргумент извън очаквания диапазон. Наследява публично std::logic_error и косвено std::exception.

Конструкторите му приемат съобщение като const std::string& или const char*. Членът what() предоставя текст, съответстващ на подаденото съобщение. Улавяйте изключението чрез const std::out_of_range&. Не го бъркайте с std::range_error, който описва грешки в диапазона при вътрешни изчисления и наследява std::runtime_error.

В примера checked_score изрично проверява интервала [0, 100] и отхвърля 101. Самото наличие на този клас на изключение не добавя проверка на диапазона към операциите. Примерът е предназначен за C++23; текущият работен проект включва и по-късни промени, затова показаните в него конструктори constexpr не са гаранция за C++23.

Примери

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

Резултат

score must be in [0, 100]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници