std::time_put<CharT,OutputIt>::put, std::time_put<CharT,OutputIt>::do_put
| 定义于头文件 <locale>
|
||
| public: iter_type put( iter_type out, std::ios_base& str, |
(1) | |
| public: iter_type put( iter_type out, std::ios_base& str, |
(2) | |
| protected: virtual iter_type do_put( iter_type out, std::ios_base& str, |
(3) | |
按照格式字符串 [fmtbeg, fmtend) ，转换存储于 t 所指向的 std::tm 对象中的日历日期和时间为字符串。格式字符串同 std::strftime 所用者，但用对 do_put() 的单独调用处理每个格式指定符，这可以通过扩展此刻面定制。
1) 逐步通过字符序列
[fmtbeg, fmtend) ，检验字符。每个不是格式序列的字符都被立即写入输出迭代器 out 。为鉴别格式序列，此函数如同用 std::ctype<char_type>(str.getloc()).narrow(c,0) 窄化 [fmtbeg, fmtend) 中的下个字符 c ，而若它等于 '%' ，则将下一或二个字符与 std::strftime 所辨识的格式序列列表，加此 locale 所支持的任何额外实现定义格式比较。对每个合法格式序列进行调用 do_put(out, str, fill, t, format, modifier) ，其中 format 为格式序列字符，而 modifier 是可选的格式序列修饰符（ 'E' 或 'O' ）。若修饰符不存在则使用值 '\0' 。2) 调用最终导出类的
do_put 成员函数。3) 按照由连接 '%' 、若
modifier 非 '\0' 则有其值，和 format 的值组成的格式转换序列，转换存储于 t 所指向的 std::tm 对象中的日历日期和时间为字符串。格式转译方式同函数 std::strftime ，除了描述为本地环境依赖的格式由此 locale 定义，而且可以支持另外的格式指定符（为这些要使用的实现定义格式指定符提供 fill 参数）。将字符串写入输出迭代器 out 。参数
| out | - | 输出迭代器，其中写入转换结果 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| str | - | 此函数在需要时用以获得本地环境刻面的流对象，例如用 std::ctype 窄化字符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| t | - | 指向 std::tm 对象的指针，从该对象获得日期/时间值 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| fmtbeg | - | 指向指定转换格式的 char_type 字符序列首字符的指针
格式字符串由零或更多个说明符和通常字符（除
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| fmtend | - | 指向指定转换格式的 char_type 字符序列的末字符后一位置的指针
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| fill | - | 填充字符（通常为空格） | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| format | - | 指名转换指定符的字符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| modifier | - | 可出现于 % 和转换指定符间的可选修饰符
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
返回值
指向最后产生字符后一位置的迭代器。
注解
不提供错误处理。
为实现定义的格式指定符，和使用填充和填满逻辑的用户定义的 do_put() 覆写提供 fill 字符。这种实现典型地利用来自 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++11) |
按照指定格式格式化并输出日期/时间值 (函数模板) |
| [虚] (C++11) |
从输入流释出日期/时间组分，按照指定格式 ( std::time_get<CharT,InputIt> 的虚受保护成员函数) |