CKTIS / C++
std::system_error — výjimka nesoucí chybový kód
std::system_error spojuje chybový kód s diagnostickým textem. Umožňuje předávat nízkoúrovňové chyby jako výjimky a současně zachovat strukturované informace pro programové určení příčiny.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, deklarovaný v <system_error>, je odvozen od std::runtime_error. Představuje výjimku nesoucí chybový kód, který obvykle pochází z operačního systému nebo nízkoúrovňového API. Vytvoření objektu neznamená jeho vyhození jako výjimky — k tomu slouží throw. Sám konstruktor však může vyvolat výjimku, například pokud se nepodaří přidělit paměť pro diagnostický text.
Konstruktory přijímají std::error_code nebo celé číslo a kategorii chyby, případně také popis typu std::string či const char*. code() vrací kód jako konstantní referenci; what() poskytuje diagnostický text. Nepředpokládejte konkrétní formát ani jazyk tohoto textu; rozhodujte se podle kódu, nikoli analýzou zprávy.
Příklad záměrně vyvolá chybu, aniž by provedl operaci operačního systému. std::make_error_code(std::errc::permission_denied) vytvoří kód z obecné kategorie. Porovnání s uloženým kódem poskytne deterministický výsledek, aniž by se vypisovalo na implementaci závislé what().
Příklady
#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';
}
}
Výsledek
code preserved: true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.