Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::error_code: valore di errore associato a una categoria

std::error_code memorizza un valore intero e una categoria che gli dà significato e produce il messaggio.

Versione: C++23

Sintassi

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 di <system_error> rappresenta errori del sistema operativo o di API di basso livello senza richiedere un’eccezione. Il costruttore (value, category) conserva entrambi i componenti e message() delega a category().message(value()).

Costruzione predefinita e clear() impostano valore 0 con std::system_category(). La conversione esplicita in bool controlla solo value() != 0. std::make_error_code(std::errc) crea un codice in generic_category(), quindi un intero senza categoria non identifica portabilmente un errore.

Il confronto tra due error_code considera valore e identità della categoria, mentre quello con error_condition può usare le regole di equivalenza. Il testo di message() dipende da implementazione e locale e può allocare; non usarlo per la logica o per test stabili.

Esempi

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

Risultato

1 1 0

std::error_code → 1 1 0

Fonti