std::from_chars_result
Материал из cppreference.com
| Определено в заголовочном файле <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)
| friend bool operator==( const from_chars_result&, const from_chars_result& ) = default; |
(начиная с C++20) | |
Сравнивает два аргумента, используя сравнения по умолчанию (которое использует operator== для сравнения ptr и ec соответственно).
Эта функция не видна обычному неквалифицированному или квалифицированному поиску и может быть найдена только с помощью зависящего от аргумента поиска, когда std::from_chars_result является ассоциированным классом аргументом.
Оператор != синтезируется из operator==.
operator bool
| 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.
[править] Смотрите также
| (C++17) |
преобразует последовательность символов в целое число или значение с плавающей запятой (функция) |
