cpp/locale/time get/get weekday

@1@ Public member function, calls the protected virtual member function of the most derived class. @2@ Reads successive characters from the sequence and parses out the weekday name (possibly abbreviated), using the default format for weekdays expected by this locale, which is the same format as  as used by the functions std,, and the POSIX function.

If it finds abbreviated name, followed by the characters that are valid for the full name, it continues reading until it consumes all the characters for the full name or finds a character that is not expected, in which case parsing fails even if the first few characters were a valid abbreviation.

The parsed weekday is stored in the std field.

If the end iterator is reached before a valid weekday name is read, the function sets std in. If a parsing error is encountered, the function sets std in.

Return value
Iterator pointing one past the last character in that was recognized as a part of a valid weekday name.