C++ iomanip 库 - get_time 函数

描述

此函数首先构造一个 basic_istream::sentry 类型的对象来访问输入序列。然后（如果计算哨兵对象的结果为真），它调用 time_get::get（使用流的选定区域设置）来执行提取和解析操作，并相应地调整流的内部状态标志。最后，它在返回之前销毁哨兵对象。

它用于从其应用到的输入流中提取字符，并根据参数 fmt 中指定的格式将其解释为时间和日期信息。获得的数据存储在 tmb 指向的 struct tm 对象中。

声明

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

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

参数

tmb - 指向 struct tm 类型对象的指针，其中存储提取的时间和日期信息。struct tm 是在头文件 <ctime> 中定义的类。

fmt - time_get::get 用作格式字符串的 C 字符串（请参阅 time_get::get）。charT 是 C 字符串中的字符类型。

返回值

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

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

异常

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

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

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

数据竞争

访问 fmt 指向的数组 修改 tmb 指向的对象以及从中提取的流对象。

对同一流对象的并发访问可能会导致数据竞争，除了标准流对象 cin 和 wcin 在与 stdio 同步时（在这种情况下，不会启动任何数据竞争，尽管没有保证提取的字符分配给线程的顺序）。

示例

以下示例说明了 get_time 函数。

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

int main () {
   struct std::tm when;
   std::cout << "Please, enter the time: ";
   std::cin >> std::get_time(&when,"%R");   

   if (std::cin.fail()) std::cout << "Error reading time\n";
   else {
      std::cout << "The time entered is: ";
      std::cout << when.tm_hour << " hours and " << when.tm_min << " minutes\n";
   }
   return 0;
}