std::time_put_byname

Определено в заголовке `<locale>`
template< class CharT, class OutputIt = std::ostreambuf_iterator<CharT> > class time_put_byname : public std::time_put<CharT, OutputIt>;

std::time_put_byname является std::time_put фасетом, который инкапсулирует правила форматирования времени и даты для локального набора, указанного при его создании.

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

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

CharT является одним из char и wchar_t, и
OutputIt должно удовлетворять требованиям LegacyOutputIterator.

Типы членов

Тип члена	Определение
`char_type`	`CharT`
`iter_type`	`OutputIt`

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

(конструктор)	создает новый `time_put_byname` фасет (публичная функция-член)
(деструктор)	уничтожает `time_put_byname` фасет (защищенная функция-член)

std::time_put_byname::time_put_byname

explicit time_put_byname( const char* name, std::size_t refs = 0 );
explicit time_put_byname( const std::string& name, std::size_t refs = 0 );		(с C++11)

Создает новый std::time_put_byname фасет для набора локалей с name.

refs используется для управления ресурсами: если refs == 0, реализация уничтожает фасет, когда последний std::locale объект, содержащий его, уничтожается. В противном случае объект не уничтожается.

Параметры

имя	-	имя набора локалей
refs	-	количество ссылок, связанных с фасетом

std::time_put_byname::~time_put_byname

protected:
~time_put_byname();

Уничтожает фасет.

Наследуется от std::time_put

Члены-объекты

Имя члена	Тип
`id` (статический)	`std::locale::id`

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

put	вызывает `do_put` (публичная функция-член `std::time_put<CharT,OutputIt>`)

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

do_put

[виртуальный]

форматирует дату/время и записывает в поток вывода
(виртуальная защищенная функция-член std::time_put<CharT,OutputIt>)

Пример

Выводит текущее время, используя набор локалей "C", с фасетом time_put замененными различными std::time_put_byname фасетами. Полученный результат был получен с помощью компилятора clang.

#include <codecvt>
#include <ctime>
#include <iomanip>
#include <iostream>
 
int main()
{
    std::time_t t = std::time(nullptr);
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv(std::cout.rdbuf());
    std::wostream out(&conv);
 
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("ja_JP.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
 
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("ru_RU.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
 
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("sv_SE.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
}

Возможный вывод:

木曜日 2023年10月05日 19時44分51秒
Четверг Чт 05 окт 2023 19:44:51
torsdag tor  5 okt 2023 19:44:51

См. также

time_put

форматирует содержимое std::tm для вывода в виде последовательности символов
(шаблон класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/time_put_byname