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, который его содержит. В противном случае объект не уничтожается.

Параметры

name	-	имя локали
refs	-	количество ссылок на фасет

std::time_put_byname::~time_put_byname

protected:
~time_put_byname();

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

Унаследовано от std::time_put

Данные-члены

Член	Описание
`std::locale::id` `id` [static]	идентификатор фасета

Функции-члены

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/cpp/locale/time_put_byname