База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::error_code: стойност на грешка, съчетана с категория

std::error_code съхранява цяло число и категория, която му придава значение и създава съобщението.

Версия: C++23

Синтаксис

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 от <system_error> представя грешки на операционната система или ниско ниво API без задължително изключение. Конструкторът (value, category) запазва двата компонента, а message() делегира към category().message(value()).

Конструирането по подразбиране и clear() задават стойност 0 със std::system_category(). Явното преобразуване до bool проверява само value() != 0. std::make_error_code(std::errc) създава код в generic_category(), затова число без категория не идентифицира преносимо грешка.

Сравнението на два error_code отчита стойността и идентичността на категорията, докато сравнение с error_condition може да използва правила за еквивалентност. Текстът от message() зависи от реализацията и locale и може да заделя памет; не го използвай за логика или стабилни тестове.

Примери

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

Резултат

1 1 0

std::error_code → 1 1 0

Източници