get_time
描述 (Description)
此函数首先构造一个basic_istream :: sentry类型的对象来访问输入序列。 然后(如果评估sentry对象为true),它调用time_get :: get(使用流的选定语言环境)来执行提取和解析操作,并相应地调整流的内部状态标志。 最后,它会在返回之前摧毁哨兵对象。
它用于从应用的输入流中提取字符,并将它们解释为参数fmt中指定的时间和日期信息。 获得的数据存储在由tmb指向的struct tm对象中。
声明 (Declaration)
以下是std :: get_time函数的声明。
template <class charT>
/*unspecified*/ get_time (struct tm* tmb, const charT* fmt);
参数 (Parameters)
tmb - 指向struct tm类型的对象的指针,其中存储了提取的时间和日期信息。 struct tm是标题“ctime”中定义的类。
fmt - time_get :: get使用的C字符串作为格式字符串(请参阅time_get :: get)。 charT是c-string中的字符类型。
返回值 (Return Value)
未指定。 此功能仅应用作流操纵器。
通过修改流的内部状态标志来发出错误信号 -
旗 | 错误 |
---|---|
eofbit | 输入序列没有可用的字符(到达文件末尾)。 |
failbit | 要么没有提取字符,要么提取的字符不能被解释为有效的货币值。 |
badbit | 流上的错误(例如当此函数捕获内部操作抛出的异常时)。设置时,流的完整性可能已受到影响。 |
异常 (Exceptions)
Basic guarantee - 如果抛出异常,则对象处于有效状态。
如果生成的错误状态标志不是goodbit并且成员异常被设置为针对该状态抛出,则会抛出成员类型失败的异常。
内部操作抛出的任何异常都由函数捕获和处理,设置badbit。 如果在最后一次调用异常时设置了badbit,则该函数会重新捕获捕获的异常。
数据竞争 (Data races)
访问fmt指向的数组修改tmb指向的对象和从中提取它的流对象。
同时访问同一个流对象可能会导致数据竞争,除了标准流对象cin和wcin与stdio同步时(在这种情况下,没有启动数据竞争,尽管没有保证提取字符的顺序)归于线程)。
例子 (Example)
在下面的例子中解释了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;
}