Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::error_code: valor de erro associado a uma categoria

std::error_code guarda um valor inteiro e uma categoria que lhe dá significado e produz a mensagem.

Versão: C++23

Sintaxe

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>, representa falhas do sistema operativo ou de API de baixo nível sem exigir uma exceção. O construtor (value, category) preserva ambos os componentes e message() delega em category().message(value()).

A construção predefinida e clear() definem valor 0 com std::system_category(). A conversão explícita em bool testa apenas value() != 0. std::make_error_code(std::errc) cria um código em generic_category(), pelo que um inteiro sem categoria não identifica portavelmente um erro.

Comparar dois error_code considera valor e identidade da categoria, enquanto comparar com error_condition pode usar regras de equivalência. O texto de message() depende da implementação e locale e pode alocar; não o uses para lógica do programa nem testes estáveis.

Exemplos

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

Resultado

1 1 0

std::error_code → 1 1 0

Fontes