CKTIS / C++
std::error_code: hodnota chyby spojená s kategorií
std::error_code ukládá celočíselnou hodnotu a kategorii, která jí dává význam a vytváří zprávu.
Verze: C++23
Syntaxe
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> představuje chyby operačního systému či nízkoúrovňových API bez nutnosti výjimky. Konstruktor (value, category) zachová obě části a message() deleguje na category().message(value()).
Výchozí konstrukce a clear() nastaví hodnotu 0 s std::system_category(). Explicitní převod na bool testuje jen value() != 0. std::make_error_code(std::errc) vytvoří kód v generic_category(), takže číslo bez kategorie chybu přenositelně neurčuje.
Porovnání dvou error_code zohlední hodnotu i identitu kategorie, zatímco porovnání s error_condition může použít pravidla ekvivalence kategorie. Text z message() závisí na implementaci a locale a může alokovat; nepoužívej jej pro logiku ani stabilní testy.
Pří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ýsledek
1 1 0
std::error_code → 1 1 0