Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::system_error — uma exceção que contém um código de erro

std::system_error associa um código de erro a texto de diagnóstico. Permite propagar erros de baixo nível como exceções, mantendo informação estruturada para identificar a causa por meios programáticos.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, declarado em <system_error>, deriva de std::runtime_error. Representa uma exceção que contém um código de erro, normalmente proveniente do sistema operativo ou de uma API de baixo nível. Criar o objeto não equivale a lançá-lo como exceção: é para isso que serve throw. O próprio construtor pode, no entanto, lançar uma exceção, por exemplo se falhar a alocação de memória para o texto de diagnóstico.

Os construtores aceitam um std::error_code ou um número inteiro e uma categoria de erro, opcionalmente com uma descrição do tipo std::string ou const char*. code() devolve o código por referência constante; what() fornece texto de diagnóstico. Não parta do princípio de que esse texto tem um formato ou idioma específico; tome decisões com base no código, em vez de analisar a mensagem.

O exemplo lança deliberadamente um erro sem executar uma operação do sistema operativo. std::make_error_code(std::errc::permission_denied) cria um código da categoria genérica. Compará-lo com o código guardado produz um resultado determinístico sem imprimir o what(), que depende da implementação.

Exemplos

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

Resultado

code preserved: true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes