Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::overflow_error — oznámení aritmetického přetečení

std::overflow_error deklarovaný v <stdexcept> slouží k oznámení aritmetického přetečení. Přetečení automaticky nezjišťuje: kód musí před rizikovou operací zkontrolovat meze a výjimku výslovně vyhodit.

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

Syntaxe

#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 je typ výjimky deklarovaný v <stdexcept>, který slouží k oznámení aritmetického přetečení. Veřejně dědí z std::runtime_error a nepřímo z std::exception, takže jej lze zachytit také prostřednictvím reference na kteroukoli z těchto základních tříd.

Jeho konstruktory explicit přijímají zprávu jako const std::string& nebo const char*. Zděděná metoda what() zpřístupňuje zprávu jako řetězec zakončený nulovým znakem, který se při porovnání rovná předanému textu. Zachycení pomocí const std::overflow_error& umožňuje přečíst zprávu bez kopírování výjimky.

Použití tohoto typu nezapíná kontrolu aritmetiky. Přetečení při vestavěné celočíselné aritmetice se znaménkem má nedefinované chování; try/catch z něj výjimku neudělá. Aritmetika s neznaménkovými čísly pracuje modulo 2^N a také automaticky nevyhazuje std::overflow_error. Meze kontrolujte před operací, nikoli až její výsledek.

Příklad kontroluje, zda by zvýšení hodnoty int překročilo její maximum. Pokud ano, výslovně vyhodí výjimku ještě před vyhodnocením value + 1 a obslužná rutina vypíše integer overflow. Tento záznam se vztahuje k C++23; dodaný průběžně aktualizovaný návrh normy může obsahovat pozdější doplňky, proto syntaxe neoznačuje konstruktory jako constexpr.

Příklady

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

Výsledek

integer overflow

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje