Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::error_code: hodnota chyby spojená s kategóriou

std::error_code ukladá celočíselnú hodnotu a kategóriu, ktorá jej dáva význam a vytvára správu.

Verzia: 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 z <system_error> predstavuje chyby operačného systému či nízkoúrovňových API bez nutnosti výnimky. Konštruktor (value, category) zachová obe časti a message() deleguje na category().message(value()).

Predvolená konštrukcia a clear() nastavia hodnotu 0 so std::system_category(). Explicitný prevod na bool testuje len value() != 0. std::make_error_code(std::errc) vytvorí kód v generic_category(), takže číslo bez kategórie chybu prenositeľne neurčuje.

Porovnanie dvoch error_code zohľadní hodnotu aj identitu kategórie, kým porovnanie s error_condition môže použiť pravidlá ekvivalencie kategórie. Text z message() závisí od implementácie a locale a môže alokovať; nepoužívaj ho na logiku ani stabilné testy.

Príklady

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

Výsledok

1 1 0

std::error_code → 1 1 0

Zdroje