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.