Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::errc — przenośne warunki błędów

std::errc to wyliczenie z zakresem z nagłówka <system_error>. Pozwala rozróżniać nazwane warunki błędów, w tym invalid_argument i result_out_of_range. Przy std::from_chars trzeba sprawdzić zarówno ec, jak i ptr, jeśli wymagane jest przetworzenie całego wejścia.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <system_error>

std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;

std::errc to wyliczenie z zakresem zadeklarowane w <system_error>. Jego nazwane wartości opisują przenośne warunki błędów. std::errc::invalid_argument odpowiada EINVAL, a std::errc::result_out_of_range odpowiada ERANGE. Porównuj nazwy, zamiast wpisywać na stałe wartości liczbowe. Samo przypisanie takiej wartości nie zgłasza wyjątku.

Dokładne znaczenie zależy od funkcji. Dla std::from_chars z <charconv> wartość std::errc::invalid_argument oznacza, że żaden znak nie pasował do wzorca liczby. std::errc::result_out_of_range oznacza, że rozpoznana liczba nie mieści się w typie docelowym. W obu przypadkach zmienna docelowa pozostaje niezmieniona.

Udana konwersja ustawia ec na std::errc{}. Nie oznacza to jednak zużycia całego wejścia: dla "42x" liczba zostaje odczytana, a ptr wskazuje x. Pełna konwersja wymaga jednocześnie result.ec == std::errc{} i result.ptr == end. Przykład tworzy wejście przekraczające zakres przez dopisanie 0 do zapisu maksymalnej wartości typu, bez założenia konkretnej szerokości unsigned int.

Przykłady

#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';
    }
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła