CKTIS / C++
std::errc — prenosljivi pogoji napak
std::errc je našteti tip z obsegom iz glave <system_error>. Razlikuje poimenovane pogoje napak, vključno z invalid_argument in result_out_of_range. Pri std::from_chars preverite ec in ptr, če je treba obdelati celoten vhod.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <system_error>
std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;std::errc je našteti tip z obsegom, deklariran v <system_error>. Njegove poimenovane vrednosti opisujejo prenosljive pogoje napak. std::errc::invalid_argument ustreza EINVAL, std::errc::result_out_of_range pa ustreza ERANGE. Primerjajte imena, namesto da bi številčne vrednosti zapisali neposredno. Dodelitev ene od teh vrednosti sama po sebi ne sproži izjeme.
Natančen pomen je odvisen od funkcije. Pri std::from_chars iz <charconv> std::errc::invalid_argument pomeni, da se noben znak ni ujemal z vzorcem števila. std::errc::result_out_of_range pomeni, da prepoznanega števila ni mogoče predstaviti v ciljnem tipu. V obeh primerih ciljna spremenljivka ostane nespremenjena.
Uspešna pretvorba nastavi ec na std::errc{}. To pa ne zagotavlja, da je bil obdelan celoten vhod: pri "42x" se število razčleni, ptr pa kaže na x. Za popolno pretvorbo morata veljati tako result.ec == std::errc{} kot result.ptr == end. Primer ustvari vhod zunaj območja tako, da decimalni največji vrednosti tipa doda 0, ne da bi predpostavljal določeno širino tipa unsigned int.
Primeri
#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';
}
}
Rezultat
complete value=42 invalid_argument value=7 result_out_of_range value=7 partial value=42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.