std::num_put<CharT,OutputIt>::put, std::num_put<CharT,OutputIt>::do_put

public:
iter_type put( iter_type out, std::ios_base& str,
               char_type fill, bool val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, long val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, long long val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, unsigned long val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, unsigned long long val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, double val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, long double val ) const;

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, const void* val ) const;

protected:
virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, bool val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, long val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, long long val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, unsigned long val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, unsigned long long val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, double val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, long double val ) const;

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, const void* val ) const;

Преобразование выполняется в четыре этапа:

Этап 1: выбор спецификатора преобразования

• Флаги формата ввода-вывода извлекаются так, как если бы это выполнялось следующим образом:

fmtflags basefield = (str.flags() & std::ios_base::basefield);

fmtflags uppercase = (str.flags() & std::ios_base::uppercase);

fmtflags floatfield = (str.flags() & std::ios_base::floatfield);

fmtflags showpos = (str.flags() & std::ios_base::showpos);

fmtflags showbase = (str.flags() & std::ios_base::showbase);

fmtflags showpoint = (str.flags() & std::ios_base::showpoint);

• Если тип val — bool:
  • Если boolalpha == 0, то val преобразуется к типу int и выполняется целочисленный вывод.
  • Если boolalpha != 0, извлекается std::use_facet<std::numpunct<CharT>>(str.getloc()).truename(), если val == true, или std::use_facet<std::numpunct<CharT>>(str.getloc()).falsename(), если val == false, а затем каждый очередной символ c этой строки выводится в out с помощью *out++ = c. В этом случае дальнейшая обработка не выполняется, функция возвращает out.
• Если тип val является целочисленным типом, выбирается первый подходящий вариант из следующих:
  • Если basefield == oct, используется спецификатор преобразования %o.
  • Если basefield == hex && !uppercase, используется спецификатор преобразования %x.
  • Если basefield == hex, используется спецификатор преобразования %X.
  • Если тип val знаковый, используется спецификатор преобразования %d.
  • Если тип val беззнаковый, используется спецификатор преобразования %u.
• Для целочисленных типов при необходимости к спецификации преобразования добавляется модификатор длины: l для long и unsignedlong, ll для longlong и unsignedlonglong(начиная с C++11).
• Если тип val является типом с плавающей точкой, выбирается первый подходящий вариант из следующих:

• Если floatfield == std::ios_base::scientific && !uppercase, используется спецификатор преобразования %e.
• Если floatfield == std::ios_base::scientific, используется спецификатор преобразования %E.

• Если !uppercase, используется спецификатор преобразования %g.
• В противном случае используется спецификатор преобразования %G.

Кроме того:

• Если тип val — longdouble, к спецификатору преобразования добавляется модификатор длины L.
• Если тип val является типом с плавающей точкой и floatfield != (ios_base::fixed | ios_base::scientific)(начиная с C++11), добавляется модификатор точности со значением str.precision(). В противном случае точность не задаётся.

• Для целочисленных типов и типов с плавающей точкой, если установлен showpos, в начало добавляется модификатор +.
• Для целочисленных типов, если установлен showbase, в начало добавляется модификатор #.
• Для типов с плавающей точкой, если установлен showpoint, в начало добавляется модификатор #.
• Если тип val — void*, используется спецификатор преобразования %p
• Создаётся строка узких символов, как если бы был вызван std::printf(spec, val) в локали "C", где spec — выбранный спецификатор преобразования.

Этап 2: преобразование с учётом локали

• Каждый символ c, полученный на этапе 1, кроме десятичного разделителя '.', преобразуется в CharT вызовом std::use_facet<std::ctype<CharT>>(str.getloc()).widen(c).
• Для арифметических типов в последовательность вставляется символ-разделитель тысяч, полученный из std::use_facet<std::numpunct<CharT>>(str.getloc()).thousands_sep(), в соответствии с правилами группировки, заданными std::use_facet<std::numpunct<CharT>>(str.getloc()).grouping().
• Символы десятичного разделителя ('.') заменяются на std::use_facet<std::numpunct<CharT>>(str.getloc()).decimal_point().

Этап 3: дополнение

• Флаг выравнивания извлекается так, как если бы это выполнялось с помощью std::fmtflags adjustfield = (flags & (std::ios_base::adjustfield)), и проверяется для определения положения символов дополнения следующим образом:
  • Если adjustfield == std::ios_base::left, символы дополнения добавляются после.
  • Если adjustfield == std::ios_base::right, символы дополнения добавляются перед.
  • Если adjustfield == std::ios_base::internal и в представлении присутствует знак, символы дополнения добавляются после знака.
  • Если adjustfield == std::ios_base::internal и представление этапа 1 начинается с 0x или 0X, символы дополнения добавляются после x или X.
  • В противном случае символы дополнения добавляются перед.
• Если str.width() не равен нулю (например, только что был использован std::setw) и количество символов CharT после этапа 2 меньше str.width(), копии символа fill вставляются в указанное положение, чтобы увеличить длину последовательности до str.width().

В любом случае вызывается str.width(0), чтобы отменить действие std::setw.

Этап 4: вывод

Каждый очередной символ c из последовательности символов CharT, полученной на этапе 3, выводится так, как если бы был вызван *out++ = c.

Параметры

Возвращаемое значение

out

Примечания

Начальный ноль, создаваемый спецификатором преобразования #o (например, в результате сочетания std::showbase и std::oct), не считается символом заполнения.

Пример

#include <iostream>
#include <locale>

// this custom num_put outputs squares of all integers (except long long)
struct squaring_num_put : std::num_put<char>
{
    iter_type do_put(iter_type out, std::ios_base& str,
                     char_type fill, long val) const
    {
        return std::num_put<char>::do_put(out, str, fill, val * val);
    }
    
    iter_type do_put(iter_type out, std::ios_base& str,
                     char_type fill, unsigned long val) const
    {
        return std::num_put<char>::do_put(out, str, fill, val * val);
    }
};

int main()
{
    auto& facet = std::use_facet<std::num_put<char>>(std::locale());
    facet.put(std::cout, std::cout, '0', 2.71);
    std::cout << '\n';
    
    std::cout.imbue(std::locale(std::cout.getloc(), new squaring_num_put));
    std::cout << 6 << ' ' << -12 << '\n';
}

2.71
36 144

#include <iostream>
#include <iterator>
#include <locale>

struct base { long x = 10; };

template<class CharT, class Traits>
std::basic_ostream<CharT, Traits>&
    operator<<(std::basic_ostream<CharT, Traits>& os, const base& b)
{
    try
    {
        typename std::basic_ostream<CharT, Traits>::sentry s(os);
        
        if (s)
        {
            std::ostreambuf_iterator<CharT, Traits> it(os);
            std::use_facet<std::num_put<CharT>>(os.getloc())
                .put(it, os, os.fill(), b.x);
        }
    }
    catch (...)
    {
        // set badbit on os and rethrow if required
    }
    
    return os;
}

int main()
{
    base b;
    std::cout << b;
}

10

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

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

См. также