CKTIS / C++
std::overflow_error — sporočanje aritmetičnega prekoračenja
std::overflow_error, deklariran v <stdexcept>, se uporablja za sporočanje aritmetičnega prekoračenja. Prekoračenja ne zazna samodejno: koda mora pred tvegano operacijo preveriti meje in izjemo izrecno vreči.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 vrsta izjeme, deklarirana v <stdexcept>, ki se uporablja za sporočanje aritmetičnega prekoračenja. Javno izhaja iz std::runtime_error in posredno iz std::exception, zato jo je mogoče ujeti tudi prek reference na enega od teh osnovnih razredov.
Njena konstruktorja explicit sprejemata sporočilo kot const std::string& ali const char*. Podedovana metoda what() omogoča dostop do sporočila kot do ničelno zaključene znakovne nize, ki je pri primerjavi enaka podanemu besedilu. Ujemanje z const std::overflow_error& omogoča branje sporočila brez kopiranja izjeme.
Uporaba te vrste ne vklopi preverjanja aritmetike. Prekoračenje pri vgrajeni celoštevilski aritmetiki s predznakom povzroči nedefinirano vedenje; try/catch tega ne spremeni v izjemo. Aritmetika z nepredznačenimi števili deluje po modulu 2^N in prav tako ne vrže samodejno std::overflow_error. Meje preverite pred operacijo, ne šele njenega rezultata.
Primer preveri, ali bi povečanje vrednosti int preseglo njeno največjo vrednost. Če bi jo, izrecno vrže izjemo, preden se izračuna value + 1, upravljalnik pa izpiše integer overflow. Ta vnos se nanaša na C++23; priloženi sproti razvijajoči se osnutek standarda lahko prikazuje poznejše dodatke, zato konstruktorji v sintaksi niso označeni kot constexpr.
Primeri
#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';
}
}
Rezultat
integer overflow
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.