CKTIS / C++
std::system_error — eine Ausnahme mit Fehlercode
std::system_error verbindet einen Fehlercode mit diagnostischem Text. So können Fehler niedrigerer Ebenen als Ausnahmen weitergegeben werden, während strukturierte Informationen zur programmgesteuerten Ermittlung der Ursache erhalten bleiben.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <system_error>
std::system_error(ec)
std::system_error(ec, what_arg)
std::system_error(value, category)
std::system_error(value, category, what_arg)
const std::error_code& code() const noexcept;
const char* what() const noexcept override;std::system_error aus <system_error> leitet sich von std::runtime_error ab. Der Typ steht für eine Ausnahme mit Fehlercode, der typischerweise vom Betriebssystem oder einer API niedrigerer Ebene stammt. Das Erzeugen des Objekts wirft dieses nicht als Ausnahme — dazu dient throw. Der Konstruktor selbst kann jedoch eine Ausnahme werfen, etwa wenn für den Diagnosetext kein Speicher bereitgestellt werden kann.
Die Konstruktoren akzeptieren ein std::error_code oder eine Ganzzahl und eine Fehlerkategorie, optional ergänzt durch eine Beschreibung vom Typ std::string oder const char*. code() gibt den Code als konstante Referenz zurück; what() stellt diagnostischen Text bereit. Gehe weder von einem bestimmten Format noch von einer bestimmten Sprache dieses Textes aus; triff Entscheidungen anhand des Codes, statt die Meldung auszuwerten.
Das Beispiel löst absichtlich einen Fehler aus, ohne einen Betriebssystemvorgang auszuführen. std::make_error_code(std::errc::permission_denied) erstellt einen Code aus der allgemeinen Kategorie. Der Vergleich mit dem gespeicherten Code liefert ein deterministisches Ergebnis, ohne das implementierungsabhängige what() auszugeben.
Beispiele
#include <iostream>
#include <system_error>
int main() {
const auto expected = std::make_error_code(std::errc::permission_denied);
try {
throw std::system_error(expected, "demo operation");
} catch (const std::system_error& e) {
std::cout << std::boolalpha
<< "code preserved: " << (e.code() == expected) << '\n';
}
}
Ergebnis
code preserved: true
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.