std::time_get<CharT,InputIt>::get_date,std::time_get<CharT,InputIt>::do_get_date (3) - Linux Manuals
std::time_get<CharT,InputIt>::get_date,std::time_get<CharT,InputIt>::do_get_date: std::time_get<CharT,InputIt>::get_date,std::time_get<CharT,InputIt>::do_get_date
NAME
std::time_get<CharT,InputIt>::get_date,std::time_get<CharT,InputIt>::do_get_date - std::time_get<CharT,InputIt>::get_date,std::time_get<CharT,InputIt>::do_get_date
Synopsis
Defined in header <locale>
public:
iter_type get_date( iter_type beg, iter_type end, std::ios_base& str, (1)
std::ios_base::iostate& err, std::tm* t ) const;
protected:
virtual iter_type do_get_date( iter_type beg, iter_type end, std::ios_base& str, (2)
std::ios_base::iostate& err, std::tm* t ) const;
1) Public member function, calls the protected virtual member function do_get_date() of the most derived class.
2) 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 the same format as
"%x" (until C++11)
"%d/%m/%y", "%m/%d/%y", "%y/%m/%d", and "%y/%d/%m", depending on date_order() (since C++11)
as used by the functions std::get_time(), get(), and the POSIX function strptime()
The parsed date is stored in the corresponding fields of the std::tm structure pointed to by the argument t.
If the end iterator is reached before a valid date is read, the function sets std::ios_base::eofbit in err. If a parsing error is encountered, the function sets std::ios_base::failbit in err.
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
Return value
Iterator pointing one past the last character in [beg, end) that was recognized as a part of a valid date.
Notes
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.
Example
// Run this code
Output:
See also
get_time parses a date/time value of specified format
(C++11)