WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::error_code: Fehlerwert mit Kategorie

std::error_code speichert einen ganzzahligen Wert und eine Kategorie, die ihm Bedeutung gibt und die Meldung erzeugt.

Version: C++23

Syntax

class error_code {
public:
    error_code() noexcept;
    error_code(int value, const std::error_category& category) noexcept;
    int value() const noexcept;
    const std::error_category& category() const noexcept;
    std::string message() const;
    explicit operator bool() const noexcept;
    void clear() noexcept;
};

std::error_code aus <system_error> stellt Betriebssystem- oder Low-Level-API-Fehler ohne erforderliche Ausnahme dar. Der Konstruktor (value, category) bewahrt beide Bestandteile, und message() delegiert an category().message(value()).

Standardkonstruktion und clear() setzen Wert 0 mit std::system_category(). Die explizite Konvertierung nach bool prüft nur value() != 0. std::make_error_code(std::errc) erzeugt einen Code in generic_category(); eine Zahl ohne Kategorie identifiziert daher keinen portablen Fehler.

Beim Vergleich zweier error_code zählen Wert und Kategorieidentität, während der Vergleich mit error_condition Äquivalenzregeln der Kategorie nutzen kann. Der Text von message() hängt von Implementierung und Locale ab und kann allozieren; er eignet sich weder für Programmlogik noch stabile Tests.

Beispiele

#include <iostream>
#include <system_error>

int main() {
    std::error_code error = std::make_error_code(std::errc::permission_denied);
    std::cout << static_cast<bool>(error) << ' '
              << (error.category() == std::generic_category()) << ' ';
    error.clear();
    std::cout << static_cast<bool>(error) << '\n';
}

Ergebnis

1 1 0

std::error_code → 1 1 0

Quellen