База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::errc — преносими условия за грешка

std::errc е изброим тип с обхват от <system_error>. Той различава именувани условия за грешка, включително invalid_argument и result_out_of_range. При std::from_chars проверявайте ec и ptr, ако трябва да се обработи целият вход.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <system_error>

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

std::errc е изброим тип с обхват, деклариран в <system_error>. Именуваните му стойности описват преносими условия за грешка. std::errc::invalid_argument съответства на EINVAL, а std::errc::result_out_of_range съответства на ERANGE. Сравнявайте имената, вместо да задавате числовите стойности директно. Присвояването на такава стойност само по себе си не хвърля изключение.

Точното значение зависи от функцията. При std::from_chars от <charconv> std::errc::invalid_argument означава, че нито един знак не съвпада с числовия шаблон. std::errc::result_out_of_range означава, че разпознатото число не може да бъде представено в целевия тип. И в двата случая целевата променлива остава непроменена.

Успешното преобразуване задава ec на std::errc{}. Това обаче не гарантира, че е обработен целият вход: при "42x" числото се прочита, а ptr сочи към x. Пълното преобразуване изисква едновременно result.ec == std::errc{} и result.ptr == end. Примерът създава вход извън диапазона, като добавя 0 към десетичния запис на максималната стойност на типа, без да предполага конкретна ширина на unsigned int.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници