KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::error_code: foutwaarde gekoppeld aan een categorie

std::error_code bewaart een geheel getal en een categorie die er betekenis aan geeft en het bericht maakt.

Versie: 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 uit <system_error> vertegenwoordigt fouten van het besturingssysteem of laag-niveau-API’s zonder een uitzondering te vereisen. De constructor (value, category) bewaart beide componenten en message() delegeert naar category().message(value()).

Standaardconstructie en clear() zetten waarde 0 met std::system_category(). Expliciete conversie naar bool test alleen value() != 0. std::make_error_code(std::errc) maakt een code in generic_category(), zodat een getal zonder categorie een fout niet draagbaar identificeert.

Vergelijking van twee error_code-objecten gebruikt waarde en categorie-identiteit; vergelijking met error_condition kan categorie-equivalentie gebruiken. Tekst van message() hangt af van implementatie en locale en kan alloceren; gebruik hem niet voor programmalogica of stabiele tests.

Voorbeelden

#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';
}

Resultaat

1 1 0

std::error_code → 1 1 0

Bronnen