Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::errc — přenositelné chybové podmínky

std::errc je výčtový typ z hlavičky <system_error>, jehož pojmenované hodnoty mají rozsah platnosti omezený na samotný výčet. Rozlišuje pojmenované chybové podmínky včetně invalid_argument a result_out_of_range. Pokud je nutné zpracovat celý vstup, u std::from_chars kontrolujte ec i ptr.

Verze: 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 je výčtový typ deklarovaný v <system_error>, jehož pojmenované hodnoty mají rozsah platnosti omezený na samotný výčet. Jeho pojmenované hodnoty popisují přenositelné chybové podmínky. std::errc::invalid_argument odpovídá EINVAL a std::errc::result_out_of_range odpovídá ERANGE. Porovnávejte názvy místo pevně zadaných číselných hodnot. Přiřazení jedné z těchto hodnot samo o sobě nevyvolá výjimku.

Přesný význam závisí na funkci. U std::from_chars z <charconv> znamená std::errc::invalid_argument, že žádné znaky neodpovídaly číselnému vzoru. std::errc::result_out_of_range znamená, že rozpoznané číslo nelze reprezentovat v cílovém typu. V obou případech zůstává cílová proměnná nezměněná.

Úspěšná konverze nastaví ec na std::errc{}. To ale nezaručuje, že byl zpracován celý vstup: pro "42x" se číslo přečte a ptr ukazuje na x. Úplná konverze vyžaduje současně result.ec == std::errc{} a result.ptr == end. Příklad vytvoří vstup mimo rozsah připojením 0 k maximální hodnotě typu v desítkovém zápisu, aniž by předpokládal konkrétní šířku unsigned int.

Pří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ýsledek

complete value=42
invalid_argument value=7
result_out_of_range value=7
partial value=42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje