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.