KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::system_error — een exception met een foutcode

std::system_error combineert een foutcode met diagnostische tekst. Zo kunnen fouten op laag niveau als exceptions worden doorgegeven, terwijl gestructureerde informatie behouden blijft om de oorzaak programmatisch vast te stellen.

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

Syntax

#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, gedeclareerd in <system_error>, is afgeleid van std::runtime_error. Het stelt een exception met een foutcode voor, doorgaans afkomstig van het besturingssysteem of een API op laag niveau. Alleen door het object te construeren werp je het nog niet als exception op; daarvoor dient throw. De constructor kan zelf wel een exception opwerpen, bijvoorbeeld als het niet lukt om geheugen voor de diagnostische tekst toe te wijzen.

De constructors accepteren een std::error_code of een geheel getal met een foutcategorie, eventueel aangevuld met een beschrijving van het type std::string of const char*. code() retourneert de code als constante referentie; what() levert diagnostische tekst. Ga niet uit van een bepaalde indeling of taal voor die tekst; neem beslissingen op basis van de code en niet door het bericht te ontleden.

Het voorbeeld werpt bewust een fout op zonder een bewerking van het besturingssysteem uit te voeren. std::make_error_code(std::errc::permission_denied) maakt een code met de algemene categorie. De vergelijking met de opgeslagen code levert een deterministisch resultaat op, zonder de implementatieafhankelijke what() af te drukken.

Voorbeelden

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

Resultaat

code preserved: true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen