1) Public member function, calls the protected virtual member function do_get_date
of the most derived class.
Reads successive characters from the sequence
[
beg,
end)
and parses out the calendar date value using the default format expected by this locale, which is determined as
date_order() Formatno_order
"%m/%d/%y" dmy
"%d/%m/%y" mdy
"%m/%d/%y" ymd
"%y/%m/%d" ydm
"%y/%d/%m"
The parsed date is stored in the corresponding fields of the
std::tmstructure pointed to by the argument
t.
[edit] Parameters beg - iterator designating the start of the sequence to parse end - one past the end iterator for the sequence to parse str - a stream object that this function uses to obtain locale facets when needed, e.g. std::ctype to skip whitespace or std::collate to compare strings err - stream error flags object that is modified by this function to indicate errors t - pointer to the std::tm object that will hold the result of this function call [edit] Return valueIterator pointing one past the last character in [
beg,
end)
that was recognized as a part of a valid date.
For the alphabetic components of the default date format (if any), this function is usually case-insensitive.
If a parsing error is encountered, most implementations of this function leave *t unmodified.
The implementation may support other date formats besides the ones required by the standard.
[edit] ExampleOutput:
Parsing the date out of '02/01/2013' in the locale en_US.utf8 Day: 1 Month: 2 Year: 2013 Parsing the date out of '02-01-2013' in the locale en_US.utf8 Parse failed. Unparsed string: -01-2013 Parsing the date out of '2013å¹´02æ01æ¥' in the locale ja_JP.utf8 Day: 1 Month: 2 Year: 2013[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior LWG 248 C++98eofbit
was not set upon reaching the end iterator sets eofbit
if a valid date has not been read LWG 461 C++98 do_get_date
needed to parse localized date representation parses with the format determined by date_order() [edit] See also parses a date/time value of specified format
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4