База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::system_error — изключение, което носи код за грешка

std::system_error съчетава код за грешка с диагностичен текст. Позволява грешки от ниско ниво да се предават като изключения, като същевременно запазва структурирана информация за програмно установяване на причината.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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, деклариран в <system_error>, наследява std::runtime_error. Той представлява изключение, което носи код за грешка, обикновено от операционната система или API от ниско ниво. Създаването на обекта само по себе си не означава, че той се хвърля като изключение — за това служи throw. Самият конструктор обаче може да хвърли изключение, например ако не успее да задели памет за диагностичния текст.

Конструкторите приемат std::error_code или цяло число и категория на грешката, по избор с описание от тип std::string или const char*. code() връща кода като константна референция; what() предоставя диагностичен текст. Не приемайте, че текстът има определен формат или език; вземайте решения според кода, а не чрез анализиране на съобщението.

Примерът умишлено хвърля грешка, без да извършва операция на операционната система. std::make_error_code(std::errc::permission_denied) създава код от общата категория. Сравнението със запазения код дава детерминиран резултат, без да отпечатва зависимия от реализацията what().

Примери

#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';
    }
}

Резултат

code preserved: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници