CKTIS / C++
std::overflow_error — rekenkundige overflow melden
std::overflow_error, gedeclareerd in <stdexcept>, wordt gebruikt om rekenkundige overflow te melden. De type detecteert overflow niet automatisch: code moet de grenzen vóór een riskante bewerking controleren en de uitzondering expliciet werpen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#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 is een uitzonderingstype dat in <stdexcept> is gedeclareerd om rekenkundige overflow te melden. Het is publiek afgeleid van std::runtime_error en indirect van std::exception, zodat het ook kan worden opgevangen via een verwijzing naar een van deze basisklassen.
De explicit-constructors accepteren een melding als const std::string& of const char*. De overgeërfde methode what() geeft de melding beschikbaar als een nulbeëindigde tekenreeks die bij vergelijking gelijk is aan de opgegeven tekst. Opvangen met const std::overflow_error& maakt het mogelijk de melding te lezen zonder de uitzondering te kopiëren.
Het gebruik van dit type schakelt geen rekenkundige controle in. Overflow bij ingebouwde rekenkundige bewerkingen met gehele getallen met teken heeft ongedefinieerd gedrag; try/catch zet dit niet om in een uitzondering. Rekenkundige bewerkingen met gehele getallen zonder teken werken modulo 2^N en werpen evenmin automatisch std::overflow_error. Controleer de grenzen vóór de bewerking, in plaats van alleen het resultaat te controleren.
Het voorbeeld controleert of het verhogen van een int de maximumwaarde zou overschrijden. Zo ja, dan werpt het expliciet een uitzondering voordat value + 1 wordt geëvalueerd, waarna de handler integer overflow afdrukt. Dit artikel richt zich op C++23; het meegeleverde evoluerende concept van de standaard kan latere toevoegingen tonen. Daarom zijn de constructors in de syntaxis niet als constexpr aangeduid.
Voorbeelden
#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';
}
}
Resultaat
integer overflow
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.