CKTIS / C++
std::system_error — iznimka koja nosi kôd pogreške
std::system_error povezuje kôd pogreške s dijagnostičkim tekstom. Omogućuje prijenos pogrešaka niske razine kao iznimki uz očuvanje strukturiranih informacija za programsko utvrđivanje uzroka.
Verzija: 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 u <system_error>, izvodi se iz std::runtime_error. Predstavlja iznimku koja nosi kôd pogreške, obično iz operacijskog sustava ili API-ja niske razine. Samo stvaranje objekta ne znači da se taj objekt baca kao iznimka — tome služi throw. Međutim, sam konstruktor može baciti iznimku, primjerice ako ne uspije dodjela memorije za dijagnostički tekst.
Konstruktori prihvaćaju std::error_code ili cijeli broj i kategoriju pogreške, uz neobavezan opis tipa std::string ili const char*. code() vraća kôd kao konstantnu referencu; what() daje dijagnostički tekst. Nemojte pretpostavljati određeni format ni jezik tog teksta; odluke donosite na temelju kôda, a ne analiziranjem poruke.
Primjer namjerno izbacuje pogrešku bez izvođenja operacije operacijskog sustava. std::make_error_code(std::errc::permission_denied) stvara kôd iz opće kategorije. Usporedba sa spremljenim kôdom daje determinističan rezultat bez ispisivanja what() koji ovisi o implementaciji.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.