std::to_chars_result
Материал из cppreference.com
| Определено в заголовочном файле <charconv>
|
||
| struct to_chars_result; |
(начиная с C++17) | |
std::to_chars_result это тип возвращаемого значения std::to_chars. Он не имеет базовых классов и имеет только следующие элементы.
Содержание |
[править] Элементы данных
| Имя | Тип |
ptr
|
const char* |
ec
|
std::errc |
[править] Дружественные функции и функции элементы
operator==(std::to_chars_result)
| friend bool operator==( const to_chars_result&, const to_chars_result& ) = default; |
(начиная с C++20) | |
Сравнивает два аргумента, используя сравнение по умолчанию (которое использует operator== для сравнения ptr и ec соответственно).
Эта функция не видна обычному неквалифицированному или квалифицированному поиску и может быть найдена только с помощью зависящего от аргумента поиска, когда std::to_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 <array> #include <charconv> #include <iostream> #include <string_view> #include <system_error> void show_to_chars(auto... format_args) { std::array<char, 10> str; #if __cpp_lib_to_chars >= 202306L // использование оператора C++26 bool() для проверки ошибок if (auto res = std::to_chars(str.data(), str.data() + str.size(), format_args...)) std::cout << std::string_view(str.data(), res.ptr) << '\n'; else std::cout << std::make_error_code(res.ec).message() << '\n'; #else if (auto [ptr, ec] = std::to_chars(str.data(), str.data() + str.size(), format_args...); ec == std::errc()) std::cout << std::string_view(str.data(), ptr) << '\n'; else std::cout << std::make_error_code(ec).message() << '\n'; #endif } int main() { show_to_chars(42); show_to_chars(+3.14159F); show_to_chars(-3.14159, std::chars_format::fixed); show_to_chars(-3.14159, std::chars_format::scientific, 3); show_to_chars(3.1415926535, std::chars_format::fixed, 10); }
Возможный вывод:
42 3.14159 -3.14159 -3.142e+00 Value too large for defined data type
[править] Смотрите также
| (C++17) |
преобразует целое число или значение с плавающей запятой в последовательность символов (функция) |
