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

CKTIS / C++

std::overflow_error — съобщаване за аритметично препълване

std::overflow_error, деклариран в <stdexcept>, служи за съобщаване за аритметично препълване. Не го открива автоматично: кодът трябва да провери границите преди рискова операция и изрично да хвърли изключението.

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

Синтаксис

#include <stdexcept>

// Constructor declarations in <stdexcept> (abridged):
// namespace std {
// class overflow_error : public runtime_error {
// public:
//     explicit overflow_error(const std::string& what_arg);
//     explicit overflow_error(const char* what_arg);
// };
// }

throw std::overflow_error("integer overflow");

std::overflow_error е тип изключение, деклариран в <stdexcept>, който служи за съобщаване за аритметично препълване. Публично наследява std::runtime_error и косвено std::exception, затова може да бъде прихванат и чрез препратка към някой от тези базови класове.

Неговите конструктори explicit приемат съобщение като const std::string& или const char*. Наследеният метод what() предоставя съобщението като низ, завършващ с нулев знак, който при сравнение е равен на подадения текст. Прихващането чрез const std::overflow_error& позволява съобщението да бъде прочетено, без изключението да се копира.

Използването на този тип не включва проверка на аритметиката. Препълването при вградената целочислена аритметика със знак води до неопределено поведение; try/catch не го превръща в изключение. Аритметиката с цели числа без знак работи по модул 2^N и също не хвърля автоматично std::overflow_error. Проверявайте границите преди операцията, а не само резултата ѝ.

Примерът проверява дали увеличаването на int би надхвърлило максималната му стойност. Ако това е така, изрично хвърля изключение, преди да се изчисли value + 1, а обработчикът извежда integer overflow. Този запис е за C++23; предоставеният развиващ се проект на стандарта може да показва по-късни допълнения, затова синтаксисът не обозначава конструкторите като constexpr.

Примери

#include <iostream>
#include <limits>
#include <stdexcept>

int checked_increment(int value) {
    if (value == std::numeric_limits<int>::max()) {
        throw std::overflow_error("integer overflow");
    }
    return value + 1;
}

int main() {
    try {
        const int result = checked_increment(std::numeric_limits<int>::max());
        std::cout << result << '\n';
    } catch (const std::overflow_error& error) {
        std::cout << error.what() << '\n';
    }
}

Резултат

integer overflow

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

Източници