public member function
<locale>

std::time_get::get_year

iter_type get_year (iter_type s, iter_type end, ios_base& str,                    ios_base::iostate& err, tm* t) const;
读取年份
解析 send 之间的字符序列,并将其解释为年份,将其值存储在 t 指向的 tm 对象中。

该函数读取字符,直到读取的字符不能成为有效年份表达式的一部分,或者到达 end。序列中的下一个字符由函数返回的迭代器指向。

如果成功,该函数将设置 tm 结构体 t 的相关成员。其余成员将保持不变。

在内部,此函数仅调用虚保护成员 do_get_year,该成员默认解析表示年份的字符序列。关于是否接受两位数年份以及(如果接受)它们属于哪个世纪,此函数未指定。

必要时,该函数会更新 err 以反映操作结果。
- 如果序列格式无效,函数将设置 failbit
- 否则,此行为未指定,尽管某些实现会为函数耗尽字符序列(即到达 end,无论成功还是失败)的情况将 err 设置为 eofbit,否则设置为 goodbit
必要时,该函数会更新 err 以反映操作结果。
- 如果序列格式无效,函数将设置 failbit
- 如果函数在其操作过程中耗尽了字符序列(即到达 end),它会设置 eofbit(单个操作可能同时设置 failbiteofbit)。
- 否则,行为是未定义的,尽管某些实现会将 err 设置为 goodbit

参数

s, end
指向序列开始和结束字符的迭代器。使用的范围是 [s,end),它包含 send 之间的所有字符,包括 s 指向的字符,但不包括 end 指向的字符。
成员类型 iter_type 是此 facet 的迭代器类型(定义为 time_get 的第二个模板参数 InputIterator 的别名)。默认情况下,这是 istreambuf_iterator,允许从 basic_istream 对象隐式转换。
str
派生自 ios_base 的类对象(通常是输入流对象)。它仅用于获取格式信息。
err
流错误状态对象,类型为 ios_base::iostate,用于存储错误状态。
t
指向 struct tm (在头文件 <ctime> 中定义)的指针,其成员在成功调用此成员函数后会被设置。

返回值

在操作之后,序列中紧随最后一个被使用字符的下一个字符。
成员类型 iter_type 是此 facet 的迭代器类型(定义为 time_get 的第二个模板参数 InputIterator 的别名)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// time_get::get_year example
#include <iostream>       // std::cout, std::ios
#include <sstream>        // std::istringstream
#include <ctime>          // std::tm
#include <locale>         // std::locale, std::time_get, std::use_facet

int main ()
{
  std::locale loc;        // classic "C" locale

  // get time_get facet:
  const std::time_get<char>& tmget = std::use_facet <std::time_get<char> > (loc);

  std::ios::iostate state;
  std::istringstream iss ("2013");
  std::tm when;

  tmget.get_year (iss, std::time_get<char>::iter_type(), iss, state, &when);

  std::cout << "year: " << when.tm_year << '\n';
  return 0;
}

可能的输出

tm_year: 113

请注意,tm_year 中的 113 被解释为 2013 年(有关更多信息,请参阅 struct tm)。

数据竞争

访问该对象以及 send 之间的整个范围。
参数 strerrt 可能会被修改。

异常安全

如果抛出异常,则“facet 对象”不会发生更改,尽管某些参数可能已被修改。

另见