Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::error_code: wartość błędu połączona z kategorią

std::error_code przechowuje całkowitą wartość oraz kategorię, która nadaje jej znaczenie i tworzy komunikat.

Wersja: C++23

Składnia

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> reprezentuje błędy systemu operacyjnego lub niskopoziomowych API bez konieczności rzucania wyjątku. Konstruktor (value, category) zachowuje oba składniki, a message() deleguje do category().message(value()).

Konstruktor domyślny i clear() ustawiają wartość 0 oraz std::system_category(). Jawna konwersja do bool sprawdza wyłącznie value() != 0. std::make_error_code(std::errc) tworzy kod w generic_category(), dlatego sama liczba bez kategorii nie identyfikuje przenośnie błędu.

Porównanie dwóch error_code uwzględnia wartość i tożsamość kategorii, natomiast porównanie z error_condition może używać reguł równoważności kategorii. Tekst z message() zależy od implementacji i lokalizacji, może też alokować; nie używaj go do logiki programu ani stabilnych testów.

Przykłady

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

Wynik

1 1 0

std::error_code → 1 1 0

Źródła