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 字符串中的字符类型。
返回值
未指定。 此函数只能用作流操纵器。
通过修改流的内部状态标志来发出错误信号 −
flag | error |
---|---|
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; }