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

public:
iter_type put( iter_type out, std::ios_base& str,
               char_type fill, const std::tm* t,
               const CharT* fmtbeg, const CharT* fmtend ) const;

public:
iter_type put( iter_type out, std::ios_base& str,
               char_type fill, const std::tm* t,
               char format, char modifier = 0 ) const;

protected:
virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, const std::tm* t,
                          char format, char modifier ) const;

Преобразует календарную дату и время, хранящиеся в объекте std::tm, указанном указателем t, в строку символов в соответствии со строкой форматирования [fmtbeg, fmtend). Строка форматирования аналогична используемой std::strftime, но каждый спецификатор формата обрабатывается отдельным вызовом do_put(), который может быть настроен путем расширения данного аспекта.

Параметры

Строка форматирования

Строка форматирования состоит из нуля или более спецификаторов преобразования и обычных символов (кроме %). Все обычные символы, включая завершающий нулевой символ, копируются в выходную строку без изменений. Каждая спецификация преобразования начинается со знака %, необязательно сопровождается E или O модификатором (игнорируется, если не поддерживается языковым окружением), а затем символом, определяющим поведение спецификатора. Доступны следующие спецификаторы формата:

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

Итератор, указывающий на позицию после последнего записанного символа.

Примечания

Обработка ошибок не предусмотрена.

Символ fill предоставляется для реализации определённых форматов и пользовательских переопределений do_put(), использующих логику заполнения и выравнивания. Такие реализации обычно используют флаги форматирования из str.

Пример

#include <iostream>
#include <sstream>
#include <iomanip>
#include <ctime>
 
void try_time_put(const std::tm* t, const std::string& fmt)
{
    std::cout.imbue(std::locale());
    std::cout << "In the locale '" << std::cout.getloc().name() << "' : '";
 
    std::use_facet<std::time_put<char>>(std::cout.getloc()).put(
        {std::cout}, std::cout, ' ', t, &fmt[0], &fmt[0] + fmt.size());
 
    std::cout << "'\n";
}
 
int main()
{
    std::time_t t = std::time(NULL);
    std::tm tm = *std::localtime(&t);
 
    std::string fmt = "%c";
    std::cout << "Using the format string '" << fmt
              << "' to format the time: " << std::ctime(&t) << '\n';
 
    std::locale::global(std::locale("de_DE.utf8"));
    try_time_put(&tm, fmt);
 
    std::locale::global(std::locale("el_GR.utf8"));
    try_time_put(&tm, fmt);
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_time_put(&tm, fmt);
}

Using the format string '%c' to format the time: Mon Feb 11 22:58:50 2013
 
In the locale 'de_DE.utf8' : 'Mo 11 Feb 2013 23:02:38 EST'
In the locale 'el_GR.utf8' : 'Δευ 11 Φεβ 2013 11:02:38 μμ EST'
In the locale 'ja_JP.utf8' : '2013年02月11日 23時02分38秒'

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

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

См. также