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]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.