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-string 作为格式字符串(参见 time_get::get)。 charT 是 c-string 中的字符类型。

返回值

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

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

旗帜	错误
eofbit	输入序列没有更多可用字符(已到达文件尾)。
failbit	或者未提取字符，或者提取的字符无法解释为有效的货币值。
badbit	流上的错误(例如当此函数捕获内部操作抛出的异常时)。设置后，流的完整性可能会受到影响。

异常

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

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

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