Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::errc — condições de erro portáveis

std::errc é uma enumeração com âmbito de <system_error>. Distingue condições de erro com nome, incluindo invalid_argument e result_out_of_range. Com std::from_chars, verifique ec e ptr se for necessário consumir toda a entrada.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <system_error>

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

std::errc é uma enumeração com âmbito declarada em <system_error>. Os seus valores com nome descrevem condições de erro portáveis. std::errc::invalid_argument corresponde a EINVAL, e std::errc::result_out_of_range corresponde a ERANGE. Compare os nomes em vez de fixar valores numéricos no código. Atribuir um destes valores não lança, por si só, uma exceção.

O significado exato depende da função. Para std::from_chars de <charconv>, std::errc::invalid_argument significa que nenhum carácter correspondeu ao padrão numérico. std::errc::result_out_of_range significa que o número reconhecido não pode ser representado pelo tipo de destino. Em ambos os casos, a variável de destino permanece inalterada.

Uma conversão bem-sucedida define ec como std::errc{}. No entanto, isso não garante que toda a entrada tenha sido consumida: para "42x", o número é analisado e ptr aponta para x. Uma conversão completa requer tanto result.ec == std::errc{} como result.ptr == end. O exemplo cria uma entrada fora do intervalo ao acrescentar 0 ao valor decimal máximo do tipo, sem pressupor uma largura específica para unsigned int.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes