Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::error_code: vrednost napake skupaj s kategorijo

std::error_code hrani celoštevilsko vrednost in kategorijo, ki ji da pomen in ustvari sporočilo.

Različica: C++23

Sintaksa

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 iz <system_error> predstavlja napake operacijskega sistema ali nizkonivojskih API-jev brez zahteve po izjemi. Konstruktor (value, category) ohrani obe sestavini, message() pa posreduje klic category().message(value()).

Privzeta gradnja in clear() nastavita vrednost 0 s std::system_category(). Izrecna pretvorba v bool preveri le value() != 0. std::make_error_code(std::errc) ustvari kodo v generic_category(), zato celo število brez kategorije napake ne določa prenosljivo.

Primerjava dveh error_code upošteva vrednost in identiteto kategorije, primerjava z error_condition pa lahko uporabi ekvivalenco kategorije. Besedilo iz message() je odvisno od izvedbe in locale ter lahko dodeljuje pomnilnik; ne uporabljaj ga za logiko ali stabilne teste.

Primeri

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

Rezultat

1 1 0

std::error_code → 1 1 0

Viri