time_get::get_year

iter_type get_year ( iter_type s, iter_type end, ios_base& str,
                     ios_base::iostate& err, tm* t) const;

Read year

Parameters

s, end

Iterators pointing to the beginning and ending characters of the sequence. The range used is [s,end), which contains all the characters between s and end, including the character pointed by s but not the character pointed by end.
iter_type is a member alias of the second template parameter of time_get (i.e., the facet's iterator type).

str

Object of a class derived from ios_base (generally an input stream object). It is used to obtain formatting information.

err

Stream error state object, of type ios_base::iostate where the resulting state will be stored.

t

Pointer to an object of type struct tm (see ctime), whose members may be set by a call to this member function.

Return value

Example

// time_get::get_year example
#include <iostream>
#include <sstream>
#include <locale>
using namespace std;
int main ()
{
  locale loc;    // "C" locale
  // get time_get facet:
  const time_get<char>& tmget = use_facet <time_get<char> > (loc);
  ios::iostate state;
  istringstream iss ("2009");
  istreambuf_iterator<char> itbegin (iss);  // beginning of iss
  istreambuf_iterator<char> itend;          // end-of-stream
  tm when;
  tmget.get_year (itbegin, itend, iss, state, &when);
  cout << "tm_year: " << when.tm_year << endl;
  return 0;
}

tm_year: 109

See also