Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::errc — prenosivi uvjeti pogreške

std::errc je nabrojivi tip s opsegom iz zaglavlja <system_error>. Razlikuje imenovane uvjete pogreške, uključujući invalid_argument i result_out_of_range. Uz std::from_chars provjerite i ec i ptr ako je potrebno obraditi cijeli ulaz.

Verzija: 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 nabrojivi tip s opsegom deklariran u <system_error>. Njegove imenovane vrijednosti opisuju prenosive uvjete pogreške. std::errc::invalid_argument odgovara vrijednosti EINVAL, a std::errc::result_out_of_range odgovara vrijednosti ERANGE. Uspoređujte nazive umjesto da brojčane vrijednosti zapisujete izravno. Dodjela jedne od tih vrijednosti sama po sebi ne izbacuje iznimku.

Točno značenje ovisi o funkciji. Za std::from_chars iz <charconv> vrijednost std::errc::invalid_argument znači da nijedan znak nije odgovarao brojčanom uzorku. std::errc::result_out_of_range znači da se prepoznati broj ne može prikazati u ciljnom tipu. U oba slučaja ciljna varijabla ostaje nepromijenjena.

Uspješna konverzija postavlja ec na std::errc{}. To ipak ne jamči da je obrađen cijeli ulaz: za "42x" broj se parsira, a ptr pokazuje na x. Potpuna konverzija zahtijeva i result.ec == std::errc{} i result.ptr == end. Primjer stvara ulaz izvan raspona tako što decimalnoj najvećoj vrijednosti tipa dodaje 0, bez pretpostavke o određenoj širini tipa unsigned int.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori