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.