Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::overflow_error — wyjątek zgłaszający przepełnienie arytmetyczne

std::overflow_error z nagłówka <stdexcept> służy do zgłaszania przepełnienia arytmetycznego. Nie wykrywa go automatycznie: kod musi sprawdzić granice przed wykonaniem ryzykownej operacji i jawnie rzucić wyjątek.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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 jest typem wyjątku z nagłówka <stdexcept> przeznaczonym do zgłaszania przepełnienia arytmetycznego. Dziedziczy publicznie po std::runtime_error, a pośrednio po std::exception, więc można go przechwycić także przez referencję do tych klas bazowych.

Konstruktory explicit przyjmują komunikat jako const std::string& lub const char*. Odziedziczona metoda what() udostępnia komunikat jako łańcuch zakończony znakiem zerowym, porównujący się jako równy z przekazanym tekstem. Przechwytywanie przez const std::overflow_error& pozwala odczytać komunikat bez kopiowania wyjątku.

Samo użycie tego typu nie włącza kontroli arytmetyki. Przepełnienie wbudowanej arytmetyki całkowitoliczbowej ze znakiem ma niezdefiniowane zachowanie; try/catch nie zamienia go w wyjątek. Arytmetyka bez znaku działa modulo 2^N i również nie rzuca automatycznie std::overflow_error. Sprawdzaj granice przed operacją, a nie dopiero jej wynik.

Przykład sprawdza, czy zwiększenie int o jeden przekroczyłoby jego maksimum. W takim przypadku jawnie rzuca wyjątek, zanim wykona value + 1, a procedura obsługi wypisuje integer overflow. Wpis dotyczy C++23; podany żywy szkic standardu może pokazywać późniejsze dodatki, dlatego składnia nie przypisuje konstruktorom constexpr.

Przykłady

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

Wynik

integer overflow

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła