std::from_chars_result

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

<tbody> </tbody>

Определено в заголовочном файле <charconv>
struct from_chars_result;		(начиная с C++17)

std::from_chars_result это тип возвращаемого значения std::from_chars. Он не имеет базовых классов и имеет только следующие элементы.

Элементы данных

Имя	Тип
ptr	const char*
ec	std::errc

Дружественные функции и функции элементы

operator==(std::from_chars_result)

<tbody> </tbody>

friend bool operator==( const from_chars_result&, const from_chars_result& ) = default;		(начиная с C++20)

Сравнивает два аргумента, используя сравнения по умолчанию (которое использует operator== для сравнения ptr и ec соответственно).

Эта функция не видна обычному неквалифицированному или квалифицированному поиску и может быть найдена только с помощью зависящего от аргумента поиска, когда std::from_chars_result является ассоциированным классом аргументом.

Оператор != синтезируется из operator==.

operator bool

<tbody> </tbody>

constexpr explicit operator bool() const noexcept;		(начиная с C++26)

Проверяет, успешно ли выполнено преобразование. Возвращает ec == std::errc{}.

Примечание

Макрос тест функциональности	Значение	Стандарт
__cpp_lib_to_chars	201611L	(C++17)	Элементарные преобразования строк (std::to_chars, std::from_chars)
	202306L	(C++26)	Проверка успеха или неудачи функций <charconv>

Пример

Запустить этот код

#include <cassert>
#include <charconv>
#include <iomanip>
#include <iostream>
#include <optional>
#include <string_view>
#include <system_error>

int main()
{
    for (std::string_view const str : {"1234", "15 foo", "bar", " 42", "5000000000"})
    {
        std::cout << "Строка: " << std::quoted(str) << ". ";
        int result{};
        auto [ptr, ec] = std::from_chars(str.data(), str.data() + str.size(), result);

        if (ec == std::errc())
            std::cout << "Результат: " << result << ", ptr-> " << std::quoted(ptr) << '\n';
        else if (ec == std::errc::invalid_argument)
            std::cout << "Это не число.\n";
        else if (ec == std::errc::result_out_of_range)
            std::cout << "Это число больше, чем int.\n";
    }

    // Демонстрация constexpr from_char в C++23 / демонстрация operator bool() в C++26:
    auto to_int = [](std::string_view s) -> std::optional<int>
    {
        int value{};
#if __cpp_lib_to_chars >= 202306L
        if (std::from_chars(s.data(), s.data() + s.size(), value))
#else
        if (std::from_chars(s.data(), s.data() + s.size(), value).ec == std::errc{})
#endif
            return value;
        else
            return std::nullopt;
    };

    assert(to_int("42") == 42);
    assert(to_int("foo") == std::nullopt);
#if __cpp_lib_constexpr_charconv and __cpp_lib_optional >= 202106
    static_assert(to_int("42") == 42);
    static_assert(to_int("foo") == std::nullopt);
#endif
}

Вывод:

Строка: "1234". Результат: 1234, ptr -> ""
Строка: "15 foo". Результат: 15, ptr -> " foo"
Строка: "bar". Это не число.
Строка: " 42". Это не число.
Строка: "5000000000". Это число больше, чем int.

Смотрите также

from_chars (C++17)

преобразует последовательность символов в целое число или значение с плавающей запятой (функция)