CKTIS / C++
std::errc — conditions d’erreur portables
std::errc est une énumération à portée définie dans <system_error>. Elle distingue des conditions d’erreur nommées, notamment invalid_argument et result_out_of_range. Avec std::from_chars, vérifiez ec et ptr si toute l’entrée doit être consommée.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <system_error>
std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;std::errc est une énumération à portée déclarée dans <system_error>. Ses valeurs nommées décrivent des conditions d’erreur portables. std::errc::invalid_argument correspond à EINVAL, et std::errc::result_out_of_range correspond à ERANGE. Comparez les noms au lieu de coder en dur des valeurs numériques. Affecter l’une de ces valeurs ne déclenche pas, à lui seul, une exception.
La signification précise dépend de la fonction. Pour std::from_chars de <charconv>, std::errc::invalid_argument signifie qu’aucun caractère ne correspondait au format numérique. std::errc::result_out_of_range signifie que le nombre reconnu ne peut pas être représenté par le type de destination. Dans les deux cas, la variable de destination reste inchangée.
Une conversion réussie définit ec sur std::errc{}. Cela ne garantit toutefois pas que toute l’entrée a été consommée : pour "42x", le nombre est analysé et ptr pointe sur x. Une conversion complète nécessite à la fois result.ec == std::errc{} et result.ptr == end. L’exemple construit une entrée hors plage en ajoutant 0 à la valeur décimale maximale du type, sans supposer une largeur particulière pour unsigned int.
Exemples
#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';
}
}
Résultat
complete value=42 invalid_argument value=7 result_out_of_range value=7 partial value=42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.