std::time_get::get_time

Parameters

s, end

Iterators pointing to the beginning and end 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.
Member type iter_type is the facet's iterator type (defined as an alias of time_get's second template parameter, InputIterator). By default, this is an istreambuf_iterator, allowing implicit conversions from basic_istream objects.

str

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

err

Stream error state object, of type ios_base::iostate where the error states are stored.

t

Pointer to an object of type struct tm (defined in header <ctime>), whose members are set by a successful call to this member function.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// time_get::get_time 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 ("07:30:00");
  std::tm when;
  tmget.get_time (iss, std::time_get<char>::iter_type(), iss, state, &when);
  std::cout << "hours: " << when.tm_hour << '\n';
  std::cout << "min: " << when.tm_min << '\n';
  std::cout << "sec: " << when.tm_sec << '\n';
  return 0;
}

hours: 7
min: 30
sec: 0

Data races

Exception safety

See also

time_get::get_date

Read date (public member function)

time_put::put

Write time and date (public member function)