CKTIS / C++
std::runtime_error — Ausnahme für Laufzeitfehler
std::runtime_error aus <stdexcept> meldet Fehler, die während der Programmausführung erkennbar sind. Die Klasse speichert eine über what() zugängliche Meldung und leitet öffentlich von std::exception ab.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <stdexcept>
// C++23
explicit runtime_error(const std::string& what_arg);
explicit runtime_error(const char* what_arg);
throw std::runtime_error("Service unavailable");std::runtime_error ist eine Ausnahmeklasse aus <stdexcept>, die öffentlich von std::exception abgeleitet ist. Sie steht für Fehler, die vermutlich erst während der Ausführung erkannt werden können, etwa wenn ein Dienst nicht verfügbar ist. Im Gegensatz dazu beschreibt std::logic_error Fehler in der internen Programmlogik, die sich theoretisch vermeiden lassen.
Die Konstruktoren nehmen die Meldung what_arg als const std::string& oder const char* entgegen. Die Funktion what() gibt einen Zeiger auf nullterminierten Text zurück. Nach der Konstruktion gilt für die erste Überladung strcmp(what(), what_arg.c_str()) == 0 und für die zweite strcmp(what(), what_arg) == 0. Enthält der übergebene std::string ein eingebettetes Nullzeichen ('\0'), muss what() die darauffolgenden Zeichen nicht erhalten. Die Funktion what() löst keine Ausnahme aus. Der zurückgegebene Zeiger bleibt gültig, bis das Ausnahmeobjekt zerstört oder eine seiner nicht-konstanten Memberfunktionen aufgerufen wird. Soll der Text länger erhalten bleiben, kopieren Sie ihn in einen std::string.
Verwenden Sie throw, um die Ausnahme auszulösen, und fangen Sie sie als const std::runtime_error& ab, um eine Kopie zu vermeiden. Allein durch das Erzeugen des Objekts wird es nicht als Ausnahme ausgelöst. Im Beispiel simuliert false deterministisch einen nicht verfügbaren Dienst; der catch-Block gibt Service unavailable gefolgt von einem Zeilenumbruch aus.
Dieser Eintrag bezieht sich auf C++23. Der bereitgestellte Arbeitsentwurf wird weiterentwickelt und zeigt auch constexpr-Deklarationen, die nicht als Garantien von C++23 zu verstehen sind. Ein Compiler-Flag im Repository belegt kein Laufzeitverhalten in einer Produktionsumgebung; das Beispiel muss lokal überprüft werden.
Beispiele
#include <iostream>
#include <stdexcept>
void access_service(bool available) {
if (!available) {
throw std::runtime_error("Service unavailable");
}
}
int main() {
try {
access_service(false);
} catch (const std::runtime_error& error) {
std::cout << error.what() << '\n';
}
}
Ergebnis
Service unavailable
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.