WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::overflow_error — arithmetischen Überlauf melden

std::overflow_error aus <stdexcept> dient dazu, einen arithmetischen Überlauf zu melden. Der Typ erkennt Überläufe nicht automatisch: Der Code muss vor einer riskanten Operation die Grenzen prüfen und die Ausnahme ausdrücklich auslösen.

Version: 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 ist ein in <stdexcept> deklarierter Ausnahmetyp, mit dem ein arithmetischer Überlauf gemeldet wird. Er leitet sich öffentlich von std::runtime_error und mittelbar von std::exception ab. Daher kann er auch über eine Referenz auf eine dieser Basisklassen abgefangen werden.

Die explicit-Konstruktoren akzeptieren eine Meldung als const std::string& oder const char*. Die geerbte Methode what() stellt die Meldung als nullterminierte Zeichenkette bereit, die mit dem übergebenen Text verglichen gleich ist. Beim Abfangen über const std::overflow_error& lässt sich die Meldung lesen, ohne die Ausnahme zu kopieren.

Die Verwendung dieses Typs aktiviert keine arithmetische Prüfung. Ein Überlauf bei der eingebauten vorzeichenbehafteten Ganzzahlarithmetik führt zu undefiniertem Verhalten; try/catch macht daraus keine Ausnahme. Vorzeichenlose Arithmetik arbeitet modulo 2^N und löst ebenfalls nicht automatisch std::overflow_error aus. Prüfen Sie die Grenzen vor der Operation, statt nur ihr Ergebnis zu kontrollieren.

Das Beispiel prüft, ob das Erhöhen eines int dessen Höchstwert überschreiten würde. Falls ja, löst es ausdrücklich eine Ausnahme aus, bevor value + 1 ausgewertet wird; der Handler gibt integer overflow aus. Dieser Eintrag bezieht sich auf C++23. Der bereitgestellte Entwurf des fortlaufend gepflegten Standards kann spätere Ergänzungen enthalten; deshalb sind die Konstruktoren in der Syntax nicht als constexpr gekennzeichnet.

Beispiele

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

Ergebnis

integer overflow

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen