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.