CKTIS / C++
std::errc — condiciones de error portátiles
std::errc es una enumeración con ámbito de <system_error>. Permite distinguir condiciones de error con nombre, incluidas invalid_argument y result_out_of_range. Con std::from_chars, comprueba tanto ec como ptr si es necesario consumir toda la entrada.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <system_error>
std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;std::errc es una enumeración con ámbito declarada en <system_error>. Sus valores con nombre describen condiciones de error portátiles. std::errc::invalid_argument corresponde a EINVAL, y std::errc::result_out_of_range corresponde a ERANGE. Compara los nombres en lugar de codificar valores numéricos. Asignar uno de estos valores no provoca por sí mismo una excepción.
El significado preciso depende de la función. Para std::from_chars de <charconv>, std::errc::invalid_argument significa que ningún carácter coincidió con el patrón numérico. std::errc::result_out_of_range significa que el número reconocido no se puede representar en el tipo de destino. En ambos casos, la variable de destino permanece sin cambios.
Una conversión correcta establece ec en std::errc{}. Sin embargo, esto no garantiza que se haya consumido toda la entrada: para "42x", se analiza el número y ptr apunta a x. Una conversión completa requiere tanto result.ec == std::errc{} como result.ptr == end. El ejemplo construye una entrada fuera de rango añadiendo 0 al valor decimal máximo del tipo, sin presuponer un ancho concreto para unsigned int.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.