std::num_put

template< 
    class CharT,
    class OutputIt = std::ostreambuf_iterator<CharT>
> class num_put;

Класс std::num_put описывает правила форматирования числовых значений в виде строк. В частности, поддерживаются типы bool, long, unsigned long, long long, unsigned long long(с C++11), double, long double, void*, и все типы, неявно преобразуемые к этим типам (например, int или float). Стандартные операторы вывода форматирования (например, cout << n;) используют компонент std::num_put области локализации потока ввода-вывода для генерации текстового представления чисел.

Схема наследования

Если специализация std::num_put не гарантируется стандартной библиотекой (см. ниже), поведение ее методов put() и do_put() не гарантируется в соответствии со спецификацией.

Специализации

Стандартная библиотека гарантирует предоставление следующих специализаций (они должны быть реализованы любым объектом локализации):

Кроме того, стандартная библиотека также гарантирует предоставление каждой специализации, удовлетворяющей следующим требованиям к типам:

• CharT — это один из
  • char,
  • wchar_t, и
  • любой другой тип символа, определённый реализацией, соответствующий требованиям к символам, для которых могут быть инициализированы компоненты iostream.
• OutputIt должен соответствовать требованиям LegacyOutputIterator.

Типы-члены

Члены-функции

Защищённые функции-члены

Объекты-члены

Пример

#include <iostream>
#include <iterator>
#include <locale>
#include <string>
 
int main()
{
    double n = 1234567.89;
    std::cout.imbue(std::locale("de_DE.UTF-8"));
    std::cout << "Direct conversion to string:\n"
              << std::to_string(n) << '\n'
              << "Output using a german locale:\n"
              << std::fixed << n << '\n'
              << "Output using an american locale:\n";
 
    // use the facet directly
    std::cout.imbue(std::locale("en_US.UTF-8"));
    auto& f = std::use_facet<std::num_put<char>>(std::cout.getloc());
    f.put(std::ostreambuf_iterator<char>(std::cout), std::cout, ' ', n);
    std::cout << '\n';
}

Direct conversion to string:
1234567.890000
Output using a german locale:
1.234.567,890000
Output using an american locale:
1,234,567.890000

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также