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

CKTIS / C++

std::system_error — izjema s kodo napake

std::system_error združuje kodo napake z diagnostičnim besedilom. Omogoča prenašanje nizkonivojskih napak kot izjem, pri tem pa ohrani strukturirane informacije za programsko določanje vzroka.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <system_error>
std::system_error(ec)
std::system_error(ec, what_arg)
std::system_error(value, category)
std::system_error(value, category, what_arg)
const std::error_code& code() const noexcept;
const char* what() const noexcept override;

std::system_error, deklariran v <system_error>, izhaja iz std::runtime_error. Predstavlja izjemo s kodo napake, ki običajno izvira iz operacijskega sistema ali nizkonivojskega API-ja. Ustvariti objekt še ne pomeni vreči ga kot izjemo — temu je namenjen throw. Lahko pa izjemo vrže sam konstruktor, na primer če dodelitev pomnilnika za diagnostično besedilo ne uspe.

Konstruktorji sprejemajo std::error_code ali celo število in kategorijo napake, po želji pa tudi opis tipa std::string ali const char*. code() vrne kodo kot konstantno referenco; what() zagotovi diagnostično besedilo. Ne predpostavljajte določene oblike ali jezika tega besedila; odločitve sprejemajte na podlagi kode, ne z razčlenjevanjem sporočila.

Primer namerno sproži napako, ne da bi izvedel operacijo operacijskega sistema. std::make_error_code(std::errc::permission_denied) ustvari kodo iz splošne kategorije. Primerjava s shranjeno kodo da determinističen rezultat, ne da bi izpisala od izvedbe odvisni what().

Primeri

#include <iostream>
#include <system_error>

int main() {
    const auto expected = std::make_error_code(std::errc::permission_denied);
    try {
        throw std::system_error(expected, "demo operation");
    } catch (const std::system_error& e) {
        std::cout << std::boolalpha
                  << "code preserved: " << (e.code() == expected) << '\n';
    }
}

Rezultat

code preserved: true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri