Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::system_error — una excepción que contiene un código de error

std::system_error combina un código de error con texto de diagnóstico. Permite transmitir errores de bajo nivel como excepciones y conservar información estructurada para identificar su causa mediante el programa.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#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 en <system_error>, deriva de std::runtime_error. Representa una excepción que contiene un código de error, normalmente procedente del sistema operativo o de una API de bajo nivel. Crear el objeto no equivale a lanzarlo como excepción: eso lo hace throw. Sin embargo, el propio constructor puede lanzar una excepción, por ejemplo si falla la asignación de memoria para el texto de diagnóstico.

Los constructores aceptan un std::error_code o un entero junto con una categoría de error, y opcionalmente una descripción de tipo std::string o const char*. code() devuelve el código mediante una referencia constante; what() proporciona texto de diagnóstico. No des por supuesto un formato ni un idioma concretos para ese texto; toma decisiones usando el código en lugar de analizar el mensaje.

El ejemplo lanza deliberadamente un error sin realizar ninguna operación del sistema operativo. std::make_error_code(std::errc::permission_denied) crea un código de la categoría genérica. Compararlo con el código guardado produce un resultado determinista sin imprimir el what(), que depende de la implementación.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes