Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::overflow_error — comunicar um overflow aritmético

std::overflow_error, declarado em <stdexcept>, serve para comunicar um overflow aritmético. Não deteta automaticamente os overflows: o código tem de verificar os limites antes de uma operação arriscada e lançar explicitamente a exceção.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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 é um tipo de exceção declarado em <stdexcept> que serve para comunicar um overflow aritmético. Deriva publicamente de std::runtime_error e, indiretamente, de std::exception, pelo que também pode ser capturado através de uma referência a qualquer uma destas classes base.

Os seus construtores explicit aceitam uma mensagem como const std::string& ou const char*. O método herdado what() disponibiliza a mensagem como uma cadeia terminada em nulo, que é igual ao texto fornecido quando comparada. Capturar através de const std::overflow_error& permite ler a mensagem sem copiar a exceção.

A utilização deste tipo não ativa a verificação aritmética. Um overflow na aritmética inteira com sinal integrada tem comportamento indefinido; try/catch não o transforma numa exceção. A aritmética sem sinal funciona módulo 2^N e também não lança automaticamente std::overflow_error. Verifique os limites antes da operação, em vez de verificar apenas o resultado.

O exemplo verifica se incrementar um int ultrapassaria o seu valor máximo. Se tal acontecer, lança explicitamente uma exceção antes de avaliar value + 1, e o handler escreve integer overflow. Esta entrada diz respeito a C++23; o projeto de norma evolutivo fornecido pode apresentar adições posteriores, pelo que a sintaxe não assinala os construtores como constexpr.

Exemplos

#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';
    }
}

Resultado

integer overflow

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes