WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::logic_error — Ausnahme für Programmlogikfehler

std::logic_error aus <stdexcept> beschreibt Fehler in der internen Programmlogik, etwa verletzte Vorbedingungen oder Klasseninvarianten. Die Klasse speichert eine Meldung, die über what() verfügbar ist, und leitet sich von std::exception ab.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <stdexcept>

/* Constructor declarations from std::logic_error (C++23 synopsis excerpt):
namespace std {
    class logic_error : public exception {
    public:
        explicit logic_error(const std::string& what_arg);
        explicit logic_error(const char* what_arg);
        // Other members omitted.
    };
}
*/

void f() {
    throw std::logic_error("message");
}

std::logic_error ist eine in <stdexcept> deklarierte Ausnahmeklasse, die öffentlich von std::exception abgeleitet ist. Sie steht für theoretisch vermeidbare Fehler in der Programmlogik, etwa wenn eine Operation vor der erforderlichen Konfiguration aufgerufen wird. Sie bezeichnet keinen Kompilierungsfehler: Diese Ausnahme kann während der Programmausführung ausgelöst werden.

Die Konstruktoren nehmen eine Meldung entweder als const std::string& oder als const char* entgegen und sind explicit. Die Memberfunktion what() stellt den Meldungstext bereit. Löse die Ausnahme als Wert aus und fange sie wie im Beispiel als const std::logic_error& ab.

std::invalid_argument, std::domain_error, std::length_error und std::out_of_range sind abgeleitete Klassen. Wähle einen spezifischeren Typ, wenn er zum Fehler passt. std::runtime_error bildet einen eigenen Zweig für Fehler, die mit Ereignissen außerhalb der Programmlogik zusammenhängen. Eine verletzte Vorbedingung führt nicht automatisch zu einer std::logic_error: Das Beispiel erkennt das Problem ausdrücklich und führt throw aus.

Das Beispiel ist für die Kompilierung im C++23-Modus vorgesehen. Die angegebene Website zeigt einen sich weiterentwickelnden Arbeitsentwurf und nicht den eingefrorenen Wortlaut von C++23; die dort angezeigten constexpr-Konstruktoren werden hier nicht als Funktionalität von C++23 behandelt. Das Laufzeitverhalten in einer Produktionsumgebung wurde nicht bestätigt.

Beispiele

#include <iostream>
#include <stdexcept>

void start(bool configured) {
    if (!configured) {
        throw std::logic_error("configuration required");
    }
}

int main() {
    try {
        start(false);
    } catch (const std::logic_error& error) {
        std::cout << error.what() << '\n';
    }
}

Ergebnis

configuration required

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