Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::error_code: valor de error asociado a una categoría

std::error_code almacena un valor entero y una categoría que le da significado y produce su mensaje.

Versión: C++23

Sintaxis

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 fallos del sistema operativo o de API de bajo nivel sin exigir una excepción. El constructor (value, category) conserva ambos componentes y message() delega en category().message(value()).

La construcción predeterminada y clear() fijan el valor 0 con std::system_category(). La conversión explícita a bool solo comprueba value() != 0. std::make_error_code(std::errc) crea un código en generic_category(), por lo que un entero sin categoría no identifica portablemente un error.

Comparar dos error_code considera valor e identidad de categoría; comparar con error_condition puede usar reglas de equivalencia de la categoría. El texto de message() depende de implementación y configuración regional y puede asignar memoria; no lo uses para lógica ni pruebas estables.

Ejemplos

#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

Fuentes