Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje