WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen