CKTIS / C++
std::overflow_error — oznámenie aritmetického pretečenia
std::overflow_error deklarovaný v <stdexcept> slúži na oznámenie aritmetického pretečenia. Pretečenie automaticky nezisťuje: kód musí pred rizikovou operáciou skontrolovať hranice a výnimku výslovne vyhodiť.
Verzia: 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 je typ výnimky deklarovaný v <stdexcept>, ktorý slúži na oznámenie aritmetického pretečenia. Verejne dedí z std::runtime_error a nepriamo z std::exception, takže ho možno zachytiť aj prostredníctvom referencie na ktorúkoľvek z týchto základných tried.
Jeho konštruktory explicit prijímajú správu ako const std::string& alebo const char*. Zdedená metóda what() vracia správu ako reťazec ukončený nulovým znakom, ktorý sa pri porovnaní rovná textu odovzdanému konštruktoru. Zachytenie pomocou const std::overflow_error& umožňuje prečítať správu bez kopírovania výnimky.
Použitie tohto typu nezapína kontrolu aritmetiky. Pretečenie pri vstavanej celočíselnej aritmetike so znamienkom má nedefinované správanie; try/catch z neho neurobí výnimku. Aritmetika s číslami bez znamienka pracuje modulo 2^N a tiež automaticky nevyhadzuje std::overflow_error. Hranice kontrolujte pred operáciou, nie až jej výsledok.
Príklad kontroluje, či by zvýšenie hodnoty int prekročilo jej maximum. Ak áno, výslovne vyhodí výnimku ešte pred vyhodnotením value + 1 a obslužná rutina vypíše integer overflow. Tento záznam sa vzťahuje na C++23; dodaný priebežne aktualizovaný návrh normy môže obsahovať neskoršie doplnenia, preto syntax neoznačuje konštruktory ako constexpr.
Prí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ýsledok
integer overflow
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.