KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::errc — draagbare foutcondities

std::errc is een scoped enumeratie uit <system_error>. Hiermee kunt u benoemde foutcondities onderscheiden, waaronder invalid_argument en result_out_of_range. Controleer bij std::from_chars zowel ec als ptr als de volledige invoer moet worden verwerkt.

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

Syntax

#include <system_error>

std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;

std::errc is een scoped enumeratie die is gedeclareerd in <system_error>. De benoemde waarden beschrijven draagbare foutcondities. std::errc::invalid_argument komt overeen met EINVAL, en std::errc::result_out_of_range komt overeen met ERANGE. Vergelijk de namen in plaats van numerieke waarden hard te coderen. Het toewijzen van zo’n waarde veroorzaakt op zichzelf geen uitzondering.

De precieze betekenis hangt af van de functie. Voor std::from_chars uit <charconv> betekent std::errc::invalid_argument dat geen tekens overeenkwamen met het getalpatroon. std::errc::result_out_of_range betekent dat het herkende getal niet kan worden weergegeven in het doeltype. In beide gevallen blijft de doelvariabele ongewijzigd.

Bij een geslaagde conversie wordt ec ingesteld op std::errc{}. Dat garandeert echter niet dat de volledige invoer is verwerkt: bij "42x" wordt het getal geparseerd en wijst ptr naar x. Een volledige conversie vereist zowel result.ec == std::errc{} als result.ptr == end. Het voorbeeld maakt een invoer buiten het bereik door 0 toe te voegen aan de decimale maximumwaarde van het type, zonder een specifieke breedte voor unsigned int aan te nemen.

Voorbeelden

#include <charconv>
#include <iostream>
#include <limits>
#include <string>
#include <system_error>

int main() {
    const std::string inputs[] = {
        "42",
        "abc",
        std::to_string(std::numeric_limits<unsigned int>::max()) + "0",
        "42x"
    };

    for (const auto& text : inputs) {
        unsigned int value = 7;
        const char* end = text.data() + text.size();
        const auto result = std::from_chars(text.data(), end, value);

        if (result.ec == std::errc::invalid_argument) {
            std::cout << "invalid_argument";
        } else if (result.ec == std::errc::result_out_of_range) {
            std::cout << "result_out_of_range";
        } else if (result.ec == std::errc{} && result.ptr == end) {
            std::cout << "complete";
        } else {
            std::cout << "partial";
        }
        std::cout << " value=" << value << '\n';
    }
}

Resultaat

complete value=42
invalid_argument value=7
result_out_of_range value=7
partial value=42

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