Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::system_error — un’eccezione che contiene un codice di errore

std::system_error associa un codice di errore a un testo diagnostico. Consente di propagare errori di basso livello come eccezioni, conservando informazioni strutturate per individuarne programmaticamente la causa.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#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, dichiarato in <system_error>, deriva da std::runtime_error. Rappresenta un’eccezione che contiene un codice di errore, in genere proveniente dal sistema operativo o da un’API di basso livello. Creare l’oggetto non equivale a lanciarlo come eccezione: a questo serve throw. Il costruttore stesso può tuttavia lanciare un’eccezione, ad esempio se non riesce ad allocare memoria per il testo diagnostico.

I costruttori accettano un std::error_code oppure un intero e una categoria di errore, con l’aggiunta facoltativa di una descrizione di tipo std::string o const char*. code() restituisce il codice tramite riferimento costante; what() fornisce testo diagnostico. Non dare per scontati un formato o una lingua specifici per il testo; prendi le decisioni usando il codice, anziché analizzare il messaggio.

L’esempio genera deliberatamente un errore senza eseguire operazioni del sistema operativo. std::make_error_code(std::errc::permission_denied) crea un codice della categoria generica. Confrontarlo con il codice salvato produce un risultato deterministico senza stampare il what(), che dipende dall’implementazione.

Esempi

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

Risultato

code preserved: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti