C++ iomanip 库 - put_time 函数

描述

此函数首先构造一个 basic_ostream::sentry 类型的对象来访问输出序列。然后（如果评估哨兵对象为真），它调用 time_put::put（使用流的选定区域设置）来执行格式化和插入操作，并相应地调整流的内部状态标志。最后，在返回之前销毁哨兵对象。

它用于插入 tmb 指向的日期和时间信息的表示形式，并根据参数 fmt 指定的格式进行格式化。

声明

以下是 std::put_time 函数的声明。

template <class charT>
/*unspecified*/ put_time (const struct tm* tmb, const charT* fmt);

参数

tmb − 指向 struct tm 类型对象的指针，其中包含要格式化的日期和时间信息。struct tm 是在 <ctime> 头文件中定义的类。

fmt − time_put::put 用作格式字符串的 C 字符串。它包含任意组合的常规字符和特殊格式说明符。这些格式说明符由函数替换为相应的数值，以表示 tmb 中指定的时间。

它们都以百分号 (%) 开头，如下所示：

返回值

未指定。此函数应仅用作流操作符。

错误通过修改流的内部状态标志来发出信号：

异常

基本保证 − 如果抛出异常，则对象处于有效状态。

如果结果错误状态标志不是 goodbit，并且成员异常被设置为为此状态抛出，则它会抛出一个成员类型为 failure 的异常。

内部操作抛出的任何异常都会被函数捕获并处理，并设置 badbit。如果在上次调用 exceptions 时设置了 badbit，则该函数会重新抛出捕获的异常。

数据竞争

访问 tmb 指向的对象和 fmt 指向的数组。

修改插入它的流对象。

对同一流对象的并发访问可能会导致数据竞争，除非标准流对象 (cout、cerr、clog、wcout、wcerr 和 wclog) 与 stdio 同步（在这种情况下，不会启动数据竞争，尽管不保证来自多个线程的字符的插入顺序）。

示例

下面的例子解释了 put_time 函数。

#include <iostream>
#include <iomanip>
#include <ctime>
#include <chrono>

int main () {
   using std::chrono::system_clock;
   std::time_t tt = system_clock::to_time_t (system_clock::now());

   struct std::tm * ptm = std::localtime(&tt);
   std::cout << "Now (local time): " << std::put_time(ptm,"%c") << '\n';

   return 0;
}