.TH "std::time_get_byname< _CharT, _InIter >" 3cxx "Wed Jul 28 2021" "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::time_get_byname< _CharT, _InIter > \- class time_get_byname [22\&.2\&.5\&.2]\&. .SH SYNOPSIS .br .PP .PP Inherits \fBstd::time_get< _CharT, _InIter >\fP\&. .SS "Public Types" .in +1c .ti -1c .RI "typedef _CharT \fBchar_type\fP" .br .ti -1c .RI "enum \fBdateorder\fP { \fBno_order\fP, \fBdmy\fP, \fBmdy\fP, \fBymd\fP, \fBydm\fP }" .br .ti -1c .RI "typedef _InIter \fBiter_type\fP" .br .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBtime_get_byname\fP (const char *, size_t __refs=0)" .br .ti -1c .RI "\fBtime_get_byname\fP (const \fBstring\fP &__s, size_t __refs=0)" .br .ti -1c .RI "dateorder \fBdate_order\fP () const" .br .RI "Return preferred order of month, day, and year\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm, char __format, char __modifier=0) const" .br .RI "Parse input string according to format\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm, const \fBchar_type\fP *__fmt, const \fBchar_type\fP *__fmtend) const" .br .RI "Parse input string according to format\&. " .ti -1c .RI "\fBiter_type\fP \fBget_date\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input date string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_monthname\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input month string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_time\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input time string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_weekday\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input weekday string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_year\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input year string\&. " .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "static \fBlocale::id\fP \fBid\fP" .br .RI "Numpunct facet id\&. " .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "\fBiter_type\fP \fB_M_extract_name\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, int &__member, const _CharT **__names, size_t __indexlen, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err) const" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_num\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, int &__member, int __min, int __max, size_t __len, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err) const" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_via_format\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm, const _CharT *__format) const" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_wday_or_month\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, int &__member, const _CharT **__names, size_t __indexlen, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err) const" .br .ti -1c .RI "virtual dateorder \fBdo_date_order\fP () const" .br .RI "Return preferred order of month, day, and year\&. " .ti -1c .RI "\fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP &__f, \fBios_base::iostate\fP &__err, tm *__tm, char __format, char __modifier) const" .br .RI "Parse input string according to format\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get_date\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input date string\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get_monthname\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input month string\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get_time\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input time string\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get_weekday\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input weekday string\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get_year\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, tm *__tm) const" .br .RI "Parse input year string\&. " .in -1c .SS "Static Protected Member Functions" .in +1c .ti -1c .RI "static __c_locale \fB_S_clone_c_locale\fP (__c_locale &__cloc) throw ()" .br .ti -1c .RI "static void \fB_S_create_c_locale\fP (__c_locale &__cloc, const char *__s, __c_locale __old=0)" .br .ti -1c .RI "static void \fB_S_destroy_c_locale\fP (__c_locale &__cloc)" .br .ti -1c .RI "static __c_locale \fB_S_get_c_locale\fP ()" .br .ti -1c .RI "static const char * \fB_S_get_c_name\fP () throw ()" .br .ti -1c .RI "static __c_locale \fB_S_lc_ctype_c_locale\fP (__c_locale __cloc, const char *__s)" .br .in -1c .SH "Detailed Description" .PP .SS "template .br class std::time_get_byname< _CharT, _InIter >" class time_get_byname [22\&.2\&.5\&.2]\&. .PP Definition at line 760 of file locale_facets_nonio\&.h\&. .SH "Member Function Documentation" .PP .SS "template dateorder \fBstd::time_get\fP< _CharT, _InIter >::date_order () const\fC [inline]\fP, \fC [inherited]\fP" .PP Return preferred order of month, day, and year\&. This function returns an enum from time_base::dateorder giving the preferred ordering if the format \fIx\fP given to time_put::put() only uses month, day, and year\&. If the format \fIx\fP for the associated locale uses other fields, this function returns time_base::dateorder::noorder\&. .PP NOTE: The library always returns noorder at the moment\&. .PP \fBReturns\fP .RS 4 A member of time_base::dateorder\&. .RE .PP .PP Definition at line 406 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_date_order()\&. .SS "template _GLIBCXX_END_NAMESPACE_LDBL_OR_CXX11 time_base::dateorder \fBstd::time_get\fP< _CharT, _InIter >::do_date_order\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Return preferred order of month, day, and year\&. This function returns an enum from time_base::dateorder giving the preferred ordering if the format \fIx\fP given to time_put::put() only uses month, day, and year\&. This function is a hook for derived classes to change the value returned\&. .PP \fBReturns\fP .RS 4 A member of time_base::dateorder\&. .RE .PP .PP Definition at line 684 of file locale_facets_nonio\&.tcc\&. .PP Referenced by std::time_get< _CharT, _InIter >::date_order()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __f, \fBios_base::iostate\fP & __err, tm * __tm, char __format, char __modifier) const\fC [inline]\fP, \fC [protected]\fP, \fC [inherited]\fP" .PP Parse input string according to format\&. This function parses the string according to the provided format and optional modifier\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__s\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__f\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .br \fI__format\fP Format specifier\&. .br \fI__modifier\fP Format modifier\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char not parsed\&. .RE .PP .PP Definition at line 1297 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), std::ios_base::eofbit, std::ios_base::goodbit, and std::__ctype_abstract_base< _CharT >::widen()\&. .PP Referenced by std::time_get< _CharT, _InIter >::get()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get_date (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Parse input date string\&. This function parses a date according to the format \fIX\fP and puts the results into a user-supplied struct tm\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get_date() for details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond date string\&. .RE .PP .PP Definition at line 1133 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), and std::ios_base::eofbit\&. .PP Referenced by std::time_get< _CharT, _InIter >::get_date()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get_monthname (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Parse input month string\&. This function parses a month name and puts the results into a user-supplied struct tm\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get_monthname() for details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond month name\&. .RE .PP .PP Definition at line 1176 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), std::ios_base::eofbit, std::ios_base::failbit, and std::ios_base::goodbit\&. .PP Referenced by std::time_get< _CharT, _InIter >::get_monthname()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get_time (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Parse input time string\&. This function parses a time according to the format \fIx\fP and puts the results into a user-supplied struct tm\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get_time() for details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond time string\&. .RE .PP .PP Definition at line 1116 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), and std::ios_base::eofbit\&. .PP Referenced by std::time_get< _CharT, _InIter >::get_time()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get_weekday (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Parse input weekday string\&. This function parses a weekday name and puts the results into a user-supplied struct tm\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get_weekday() for details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond weekday name\&. .RE .PP .PP Definition at line 1150 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), std::ios_base::eofbit, std::ios_base::failbit, and std::ios_base::goodbit\&. .PP Referenced by std::time_get< _CharT, _InIter >::get_weekday()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::do_get_year (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [protected]\fP, \fC [virtual]\fP, \fC [inherited]\fP" .PP Parse input year string\&. This function reads up to 4 characters to parse a year string and puts the results into a user-supplied struct tm\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get_year() for details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond year\&. .RE .PP .PP Definition at line 1202 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::eofbit, std::ios_base::failbit, and std::ios_base::goodbit\&. .PP Referenced by std::time_get< _CharT, _InIter >::get_year()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm, char __format, char __modifier = \fC0\fP) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input string according to format\&. This function calls time_get::do_get with the provided parameters\&. .PP \fBSee also\fP .RS 4 do_get() and get()\&. .RE .PP \fBParameters\fP .RS 4 \fI__s\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .br \fI__format\fP Format specifier\&. .br \fI__modifier\fP Format modifier\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char not parsed\&. .RE .PP .PP Definition at line 559 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get()\&. .SS "template _InIter \fBstd::time_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm, const \fBchar_type\fP * __fmt, const \fBchar_type\fP * __fmtend) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input string according to format\&. This function parses the input string according to a provided format string\&. It does the inverse of time_put::put\&. The format string follows the format specified for strftime(3)/strptime(3)\&. The actual parsing is done by time_get::do_get\&. .PP \fBParameters\fP .RS 4 \fI__s\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .br \fI__fmt\fP Start of the format string\&. .br \fI__fmtend\fP End of the format string\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char not parsed\&. .RE .PP .PP Definition at line 1225 of file locale_facets_nonio\&.tcc\&. .PP References std::ios_base::_M_getloc(), std::ios_base::eofbit, std::ios_base::failbit, std::ios_base::goodbit, std::__ctype_abstract_base< _CharT >::is(), std::__ctype_abstract_base< _CharT >::narrow(), std::__ctype_abstract_base< _CharT >::tolower(), and std::__ctype_abstract_base< _CharT >::toupper()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get_date (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input date string\&. This function parses a date according to the format \fIx\fP and puts the results into a user-supplied struct tm\&. The result is returned by calling time_get::do_get_date()\&. .PP If there is a valid date string according to format \fIx\fP, \fItm\fP will be filled in accordingly and the returned iterator will point to the first character beyond the date string\&. If an error occurs before the end, err |= ios_base::failbit\&. If parsing reads all the characters, err |= ios_base::eofbit\&. .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond date string\&. .RE .PP .PP Definition at line 455 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get_date()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get_monthname (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input month string\&. This function parses a month name and puts the results into a user-supplied struct tm\&. The result is returned by calling time_get::do_get_monthname()\&. .PP Parsing starts by parsing an abbreviated month name\&. If a valid abbreviation is followed by a character that would lead to the full month name, parsing continues until the full name is found or an error occurs\&. Otherwise parsing finishes at the end of the abbreviated name\&. .PP If an error occurs before the end, err |= ios_base::failbit\&. If parsing reads all the characters, err |= ios_base::eofbit\&. .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond month name\&. .RE .PP .PP Definition at line 512 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get_monthname()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get_time (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input time string\&. This function parses a time according to the format \fIX\fP and puts the results into a user-supplied struct tm\&. The result is returned by calling time_get::do_get_time()\&. .PP If there is a valid time string according to format \fIX\fP, \fItm\fP will be filled in accordingly and the returned iterator will point to the first character beyond the time string\&. If an error occurs before the end, err |= ios_base::failbit\&. If parsing reads all the characters, err |= ios_base::eofbit\&. .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond time string\&. .RE .PP .PP Definition at line 430 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get_time()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get_weekday (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input weekday string\&. This function parses a weekday name and puts the results into a user-supplied struct tm\&. The result is returned by calling time_get::do_get_weekday()\&. .PP Parsing starts by parsing an abbreviated weekday name\&. If a valid abbreviation is followed by a character that would lead to the full weekday name, parsing continues until the full name is found or an error occurs\&. Otherwise parsing finishes at the end of the abbreviated name\&. .PP If an error occurs before the end, err |= ios_base::failbit\&. If parsing reads all the characters, err |= ios_base::eofbit\&. .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond weekday name\&. .RE .PP .PP Definition at line 483 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get_weekday()\&. .SS "template \fBiter_type\fP \fBstd::time_get\fP< _CharT, _InIter >::get_year (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, tm * __tm) const\fC [inline]\fP, \fC [inherited]\fP" .PP Parse input year string\&. This function reads up to 4 characters to parse a year string and puts the results into a user-supplied struct tm\&. The result is returned by calling time_get::do_get_year()\&. .PP 4 consecutive digits are interpreted as a full year\&. If there are exactly 2 consecutive digits, the library interprets this as the number of years since 1900\&. .PP If an error occurs before the end, err |= ios_base::failbit\&. If parsing reads all the characters, err |= ios_base::eofbit\&. .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of string to parse\&. .br \fI__end\fP End of string to parse\&. .br \fI__io\fP Source of the locale\&. .br \fI__err\fP Error flags to set\&. .br \fI__tm\fP Pointer to struct tm to fill in\&. .RE .PP \fBReturns\fP .RS 4 Iterator to first char beyond year\&. .RE .PP .PP Definition at line 538 of file locale_facets_nonio\&.h\&. .PP References std::time_get< _CharT, _InIter >::do_get_year()\&. .SH "Member Data Documentation" .PP .SS "template \fBlocale::id\fP \fBstd::time_get\fP< _CharT, _InIter >::id\fC [static]\fP, \fC [inherited]\fP" .PP Numpunct facet id\&. .PP Definition at line 379 of file locale_facets_nonio\&.h\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.