CKTIS / C++
std::errc — prenositeľné chybové podmienky
std::errc je výčtový typ s rozsahom z hlavičky <system_error>. Rozlišuje pomenované chybové podmienky vrátane invalid_argument a result_out_of_range. Ak treba spracovať celý vstup, pri std::from_chars kontrolujte ec aj ptr.
Verzia: 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 je výčtový typ s rozsahom deklarovaný v <system_error>. Jeho pomenované hodnoty opisujú prenositeľné chybové podmienky. std::errc::invalid_argument zodpovedá EINVAL a std::errc::result_out_of_range zodpovedá ERANGE. Porovnávajte názvy namiesto pevne zapisovaných číselných hodnôt. Priradenie jednej z týchto hodnôt samo osebe nevyvolá výnimku.
Presný význam závisí od funkcie. Pri std::from_chars z <charconv> znamená std::errc::invalid_argument, že žiadne znaky nezodpovedali číselnému vzoru. std::errc::result_out_of_range znamená, že rozpoznané číslo nemožno reprezentovať v cieľovom type. V oboch prípadoch zostane cieľová premenná nezmenená.
Úspešná konverzia nastaví ec na std::errc{}. To však nezaručuje, že sa spracoval celý vstup: pri "42x" sa číslo načíta a ptr ukazuje na x. Úplná konverzia vyžaduje zároveň result.ec == std::errc{} aj result.ptr == end. Príklad vytvorí vstup mimo rozsahu pripojením 0 k maximálnej hodnote typu v desiatkovom zápise, bez predpokladu konkrétnej šírky unsigned int.
Príklady
#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';
}
}
Výsledok
complete value=42 invalid_argument value=7 result_out_of_range value=7 partial value=42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.