Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::errc — condizioni di errore portabili

std::errc è un’enumerazione con ambito definita in <system_error>. Distingue condizioni di errore denominate, tra cui invalid_argument e result_out_of_range. Con std::from_chars, controlla sia ec sia ptr se è necessario consumare l’intero input.

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

Sintassi

#include <system_error>

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

std::errc è un’enumerazione con ambito dichiarata in <system_error>. I suoi valori denominati descrivono condizioni di errore portabili. std::errc::invalid_argument corrisponde a EINVAL, mentre std::errc::result_out_of_range corrisponde a ERANGE. Confronta i nomi invece di codificare valori numerici. Assegnare uno di questi valori non genera di per sé un’eccezione.

Il significato preciso dipende dalla funzione. Per std::from_chars di <charconv>, std::errc::invalid_argument significa che nessun carattere corrispondeva al modello numerico. std::errc::result_out_of_range significa che il numero riconosciuto non è rappresentabile nel tipo di destinazione. In entrambi i casi, la variabile di destinazione rimane invariata.

Una conversione riuscita imposta ec a std::errc{}. Questo però non garantisce che sia stato consumato tutto l’input: con "42x", il numero viene analizzato e ptr punta a x. Una conversione completa richiede sia result.ec == std::errc{} sia result.ptr == end. L’esempio crea un input fuori intervallo aggiungendo 0 al valore decimale massimo del tipo, senza presupporre una larghezza specifica per unsigned int.

Esempi

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

Risultato

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

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