CKTIS / C++
std::system_error — wyjątek z kodem błędu
std::system_error łączy kod błędu z opisem diagnostycznym. Pozwala przekazywać błędy niskopoziomowe jako wyjątki, zachowując dane do programowego rozpoznania przyczyny.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 z <system_error> dziedziczy po std::runtime_error. Reprezentuje wyjątek z kodem błędu, zwykle pochodzącego z systemu operacyjnego lub niskopoziomowego API. Samo utworzenie obiektu nie zgłasza go jako wyjątku — do tego służy throw. Konstruktor może jednak sam zgłosić wyjątek, na przykład gdy nie uda się przydzielić pamięci na tekst diagnostyczny.
Konstruktory przyjmują std::error_code albo liczbę i kategorię błędu, opcjonalnie z opisem typu std::string lub const char*. code() zwraca kod przez stałą referencję; what() udostępnia tekst diagnostyczny. Nie zakładaj konkretnego formatu ani języka tego tekstu; decyzje podejmuj na podstawie kodu, nie analizy komunikatu.
Przykład celowo zgłasza błąd bez wykonywania operacji systemowej. std::make_error_code(std::errc::permission_denied) tworzy kod z kategorią ogólną. Porównanie z zachowanym kodem daje deterministyczny wynik bez wypisywania zależnego od implementacji what().
Przykłady
#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';
}
}
Wynik
code preserved: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.