std::time_put<CharT,OutputIt>::put, std::time_put<CharT,OutputIt>::do_put
来自cppreference.com
| 在标头 <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 所辨识的格式序列列表，加此本地环境所支持的任何额外实现定义格式比较。对每个合法格式序列进行调用 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 ，除了描述为本地环境依赖的格式由此本地环境定义，而且可以支持另外的格式指定符（为这些要使用的实现定义格式指定符提供 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 << "在本地环境 '" << 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 << "使用格式字符串 '" << fmt << "' 格式化时间：" << 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); }
可能的输出：
使用格式字符串 '%c' 格式化时间：Mon Feb 11 22:58:50 2013 在本地环境 'de_DE.utf8' 中：'Mo 11 Feb 2013 23:02:38 EST' 在本地环境 'el_GR.utf8' 中：'Δευ 11 Φεβ 2013 11:02:38 μμ EST' 在本地环境 'ja_JP.utf8' 中：'2013年02月11日 23時02分38秒'
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 164 | C++98 | 提供形参 fill 的目的不明确 | 使之明确 |
参阅
| (C++11) |
按照指定格式格式化并输出日期/时间值 (函数模板) |
| [虚] (C++11) |
从输入流按照指定格式提取日期/时间组分 ( std::time_get<CharT,InputIt> 的虚受保护成员函数) |