CKTIS / C++
std::system_error — výnimka nesúca chybový kód
std::system_error spája chybový kód s diagnostickým textom. Umožňuje odovzdávať nízkoúrovňové chyby ako výnimky a zároveň zachovať štruktúrované informácie na programové určenie príčiny.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 odvodený od std::runtime_error. Predstavuje výnimku nesúcu chybový kód, ktorý zvyčajne pochádza z operačného systému alebo nízkoúrovňového API. Vytvorenie objektu neznamená jeho vyhodenie ako výnimky — na to slúži throw. Samotný konštruktor však môže vyvolať výnimku, napríklad ak sa nepodarí prideliť pamäť pre diagnostický text.
Konštruktory prijímajú std::error_code alebo celé číslo a kategóriu chyby, prípadne aj opis typu std::string či const char*. code() vracia kód ako konštantnú referenciu; what() poskytuje diagnostický text. Nepredpokladajte konkrétny formát ani jazyk tohto textu; rozhodujte sa podľa kódu, nie na základe analýzy správy.
Príklad zámerne vyvolá chybu bez vykonania operácie operačného systému. std::make_error_code(std::errc::permission_denied) vytvorí kód zo všeobecnej kategórie. Porovnanie s uloženým kódom poskytne deterministický výsledok bez vypísania od implementácie závislého what().
Prí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ýsledok
code preserved: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.