.TH "std::time_get< _CharT, _InIter >" 3cxx "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::time_get< _CharT, _InIter > \- Primary class template time_get\&. .SH SYNOPSIS .br .PP .PP \fC#include \fP .PP Inherits \fBstd::locale::facet\fP, and \fBstd::time_base\fP\&. .PP Inherited by \fBstd::time_get_byname< _CharT, _InIter >\fP\&. .SS "Public Types" .in +1c .ti -1c .RI "enum \fBdateorder\fP { \fBno_order\fP, \fBdmy\fP, \fBmdy\fP, \fBymd\fP, \fBydm\fP }" .br .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBtypedef\fP _CharT \fBchar_type\fP" .br .RI "Public typedefs\&. " .ti -1c .RI "\fBtypedef\fP \fB_InIter\fP \fBiter_type\fP" .br .RI "Public typedefs\&. " .in -1c .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBtime_get\fP (size_t \fB__refs\fP=0)" .br .RI "Constructor performs initialization\&. " .ti -1c .RI "dateorder \fBdate_order\fP () \fBconst\fP" .br .RI "Return preferred order of month, day, and year\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP \fB__s\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP, char \fB__format\fP, char \fB__modifier\fP=0) \fBconst\fP" .br .RI "Parse input string according to format\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP \fB__s\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP, \fBconst\fP \fBchar_type\fP *\fB__fmt\fP, \fBconst\fP \fBchar_type\fP *\fB__fmtend\fP) \fBconst\fP" .br .RI "Parse input string according to format\&. " .ti -1c .RI "\fBiter_type\fP \fBget_date\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input date string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_monthname\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input month string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_time\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input time string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_weekday\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input weekday string\&. " .ti -1c .RI "\fBiter_type\fP \fBget_year\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input year string\&. " .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "\fBstatic\fP \fBlocale::id\fP \fBid\fP" .br .RI "Numpunct facet id\&. " .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "\fBvirtual\fP \fB~time_get\fP ()" .br .RI "Destructor\&. " .ti -1c .RI "\fBiter_type\fP \fB_M_extract_name\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, int &\fB__member\fP, \fBconst\fP _CharT **\fB__names\fP, size_t \fB__indexlen\fP, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP) \fBconst\fP" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_num\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, int &\fB__member\fP, int __min, int __max, size_t \fB__len\fP, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP) \fBconst\fP" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_via_format\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP, \fBconst\fP _CharT *\fB__format\fP) \fBconst\fP" .br .ti -1c .RI "\fBiter_type\fP \fB_M_extract_wday_or_month\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, int &\fB__member\fP, \fBconst\fP _CharT **\fB__names\fP, size_t \fB__indexlen\fP, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP) \fBconst\fP" .br .ti -1c .RI "\fBvirtual\fP dateorder \fBdo_date_order\fP () \fBconst\fP" .br .RI "Return preferred order of month, day, and year\&. " .ti -1c .RI "\fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP \fB__s\fP, \fBiter_type\fP __end, \fBios_base\fP &__f, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP, char \fB__format\fP, char \fB__modifier\fP) \fBconst\fP" .br .RI "Parse input string according to format\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_get_date\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input date string\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_get_monthname\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input month string\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_get_time\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input time string\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_get_weekday\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input weekday string\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_get_year\fP (\fBiter_type\fP \fB__beg\fP, \fBiter_type\fP __end, \fBios_base\fP &\fB__io\fP, \fBios_base::iostate\fP &\fB__err\fP, \fBtm\fP *\fB__tm\fP) \fBconst\fP" .br .RI "Parse input year string\&. " .in -1c .SS "Static Protected Member Functions" .in +1c .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_clone_c_locale\fP (__c_locale &\fB__cloc\fP) \fBthrow\fP ()" .br .ti -1c .RI "\fBstatic\fP \fBvoid\fP \fB_S_create_c_locale\fP (__c_locale &\fB__cloc\fP, \fBconst\fP char *\fB__s\fP, __c_locale \fB__old\fP=0)" .br .ti -1c .RI "\fBstatic\fP \fBvoid\fP \fB_S_destroy_c_locale\fP (__c_locale &\fB__cloc\fP)" .br .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_get_c_locale\fP ()" .br .ti -1c .RI "\fBstatic\fP \fBconst\fP char * \fB_S_get_c_name\fP () \fBthrow\fP ()" .br .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_lc_ctype_c_locale\fP (__c_locale \fB__cloc\fP, \fBconst\fP char *\fB__s\fP)" .br .in -1c .SH "Detailed Description" .PP .SS "template<\fBtypename\fP _CharT, \fBtypename\fP \fB_InIter\fP> .br class std::time_get< _CharT, _InIter >"Primary class template time_get\&. This facet encapsulates the code to parse and return a date or time from a string\&. It is used by the istream numeric extraction operators\&. .PP The time_get template uses protected virtual functions to provide the actual results\&. The public accessors forward the call to the virtual functions\&. These virtual functions are hooks for developers to implement the behavior they require from the time_get facet\&. .SH "Member Typedef Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBtypedef\fP _CharT \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::char_type" .PP Public typedefs\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBtypedef\fP \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::iter_type" .PP Public typedefs\&. .SH "Constructor & Destructor Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::time_get (size_t __refs = \fC0\fP)\fC [inline]\fP, \fC [explicit]\fP" .PP Constructor performs initialization\&. This is the constructor provided by the standard\&. .PP \fBParameters\fP .RS 4 \fI__refs\fP Passed to the base facet class\&. .RE .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBvirtual\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::~\fBtime_get\fP ()\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Destructor\&. .SH "Member Function Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > dateorder \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::date_order () const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_date_order()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > _GLIBCXX_END_NAMESPACE_LDBL_OR_CXX11 time_base::dateorder \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_date_order () const\fC [protected]\fP, \fC [virtual]\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 Referenced by \fBstd::time_get< _CharT, _InIter >::date_order()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __f, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm, char __format, char __modifier) const\fC [inline]\fP, \fC [protected]\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 References \fBstd::ios_base::eofbit\fP, and \fBstd::ios_base::goodbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get_date (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [protected]\fP, \fC [virtual]\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 References \fBstd::ios_base::eofbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get_date()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get_monthname (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [protected]\fP, \fC [virtual]\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 References \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get_monthname()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get_time (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [protected]\fP, \fC [virtual]\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 References \fBstd::ios_base::eofbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get_time()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get_weekday (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [protected]\fP, \fC [virtual]\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 References \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get_weekday()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::do_get_year (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [protected]\fP, \fC [virtual]\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 References \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&. .PP Referenced by \fBstd::time_get< _CharT, _InIter >::get_year()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm, char __format, char __modifier = \fC0\fP) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fB_InIter\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get (\fBiter_type\fP __s, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm, \fBconst\fP \fBchar_type\fP * __fmt, \fBconst\fP \fBchar_type\fP * __fmtend) const\fC [inline]\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 References \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get_date (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get_date()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get_monthname (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get_monthname()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get_time (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get_time()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get_weekday (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get_weekday()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBiter_type\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::get_year (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, \fBtm\fP * __tm) const\fC [inline]\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 References \fBstd::time_get< _CharT, _InIter >::do_get_year()\fP\&. .SH "Member Data Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_InIter\fP > \fBlocale::id\fP \fBstd::time_get\fP< _CharT, \fB_InIter\fP >::id\fC [static]\fP" .PP Numpunct facet id\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.