std::num_put

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

Класс std::num_put инкапсулирует правила форматирования числовых значений в виде строк. В частности, поддерживаются типы bool, long, unsignedlong, longlong, unsignedlonglong(начиная с C++11), double, longdouble, 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++.

См. также