Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::system_error — une exception portant un code d’erreur

std::system_error associe un code d’erreur à un texte de diagnostic. Il permet de transmettre des erreurs de bas niveau sous forme d’exceptions tout en conservant des informations structurées pour identifier leur cause par programme.

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

Syntaxe

#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, déclaré dans <system_error>, dérive de std::runtime_error. Il représente une exception portant un code d’erreur, provenant généralement du système d’exploitation ou d’une API de bas niveau. Construire l’objet ne revient pas à le lancer comme exception : c’est le rôle de throw. Le constructeur peut toutefois lui-même lancer une exception, par exemple si l’allocation de mémoire pour le texte de diagnostic échoue.

Les constructeurs acceptent un std::error_code ou un entier accompagné d’une catégorie d’erreur, avec éventuellement une description de type std::string ou const char*. code() renvoie le code par référence constante ; what() fournit un texte de diagnostic. Ne présumez pas d’un format ni d’une langue particulière pour ce texte ; prenez vos décisions à partir du code plutôt que d’analyser le message.

L’exemple déclenche volontairement une erreur sans effectuer d’opération du système d’exploitation. std::make_error_code(std::errc::permission_denied) crée un code de la catégorie générique. Le comparer au code conservé produit un résultat déterministe sans afficher le what() dépendant de l’implémentation.

Exemples

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

Résultat

code preserved: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources