Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje