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 中指定的时间。

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

返回值

未指定。 此函数只能用作流操纵器。

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

异常

Basic guarantee − 如果抛出异常，则对象处于有效状态。

如果生成的错误状态标志不是 goodbit 并且成员异常设置为针对该状态抛出，它会抛出成员类型失败的异常。

内部操作抛出的任何异常都会被函数捕获并处理，设置 badbit。 如果在最后一次调用异常时设置了 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;
}

❮ C++ 标准库 - <iomanip>