Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::error_code : valeur d’erreur associée à une catégorie

std::error_code stocke une valeur entière et une catégorie qui lui donne son sens et produit son message.

Version : 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 de <system_error> représente les échecs du système ou d’API bas niveau sans imposer d’exception. Le constructeur (value, category) conserve les deux composants et message() délègue à category().message(value()).

La construction par défaut et clear() fixent la valeur à 0 avec std::system_category(). La conversion explicite en bool teste seulement value() != 0. std::make_error_code(std::errc) crée un code dans generic_category() ; un entier sans catégorie n’identifie donc pas portablement une erreur.

Comparer deux error_code tient compte de la valeur et de l’identité de catégorie, tandis qu’une comparaison avec error_condition peut utiliser l’équivalence de la catégorie. Le texte de message() dépend de l’implémentation et de la locale et peut allouer ; ne l’utilise pas pour la logique ni des tests stables.

Exemples

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

Résultat

1 1 0

std::error_code → 1 1 0

Sources