Пространства имён
Варианты
    Действия

      std::to_chars_result

      Материал из cppreference.com
       
      C++
      Поддержка компилятором
      Автономные и размещённые реализации
      Язык
      Стандартная библиотека
      Заголовки стандартной библиотеки
      Требования к именованию
      Макросы тестирования функциональности (C++20)
      Поддержка языка
      Библиотека концептов (C++20)
      Библиотека метапрограммирования (C++11)
      Библиотека диагностики
      Библиотека общих утилит
      Библиотека строк
      Библиотека контейнеров
      Библиотека итераторов
      Библиотека диапазонов (C++20)
      Библиотека алгоритмов
      Библиотека численных данных
      Библиотека ввода/вывода
      Библиотека локализаций
      Регулярные выражения (C++11)
      Атомарные операции (C++11)
      Библиотека поддержки конкуренции (C++11)
      Библиотека файловой системы (C++17)
      Технические спецификации
      Указатель символов
      Внешние библиотеки
       
      Библиотека утилит
      Языковая поддержка
      Поддержка типов (базовые типы, RTTI)
      Макросы тестирования функциональности библиотеки (C++20)    
      Управление динамической памятью
      Программные утилиты
      Поддержка сопрограмм (C++20)
      Вариативные функции
      (C++20)
      (C++26)
      (C++11)
      (C++20)
      Трёхстороннее сравнение (C++20)
      (C++20)(C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)
      (C++20)    
      (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
      Общие утилиты
      Дата и время
      Функциональные объекты
      Библиотека форматирования (C++20)
      (C++11)
      Операторы отношения (устарело в C++20)
      Целочисленные функции сравнения
      (C++20)(C++20)(C++20)    
      (C++20)
      Операции обмена и типа
      (C++20)
      (C++14)
      (C++11)
      (C++23)
      (C++11)
      (C++23)
      (C++11)
      (C++11)
      (C++17)
      Общие лексические типы
      (C++11)
      (C++17)
      (C++17)
      (C++17)
      (C++11)
      (C++11)
      (C++17)
      (C++17)
      (C++23)
      Элементарные преобразования строк
      (C++17)
      (C++17)
      (C++17)
       
      <tbody> </tbody>
      Определено в заголовочном файле <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)

      <tbody> </tbody>
      friend bool operator==( const to_chars_result&, const to_chars_result& ) = default;
      		 (начиная с C++20)

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

      Эта функция не видна обычному неквалифицированному или квалифицированному поиску и может быть найдена только с помощью зависящего от аргумента поиска, когда std::to_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 <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)
      		 преобразует целое число или значение с плавающей запятой в последовательность символов
      (функция) [править]