SysTutorials

Linux Manual Pages › Section 3

stdchronofrom_streamstdchronolocal_time(3)

std::chrono::from_stream(std::chrono::local_time) - std::chrono::from_stream(std::chrono::local_time)

Synopsis

template <class CharT, class Traits, class Duration, class Alloc = std::allocator<CharT>>
std::basic_istream<CharT, Traits> &
from_stream(std::basic_istream<CharT, Traits> &is, const CharT *fmt, (since C++ 20)
                                                                         std::chrono::local_time<Duration> &tp,
            std::basic_string<CharT, Traits, Alloc> *abbrev = nullptr,
            std::chrono::minutes *offset = nullptr);

Attempts to parse the input stream is into the time point tp according to the format string fmt. Behaves as an UnformattedInputFunction, except that it has an unspecified effect on is.gcount(). After constructing and checking the sentry object, attempts to parse the input stream is into tp according to the format string fmt. If the parse fails to decode a valid time point, is.setstate(std::ios_base::failbit) is called and tp is not modified. If the format specifier %Z is used and successfully parsed, the parsed value is assigned to *abbrev if abbrev is not null. If the format specifier %z or a modified variant is used and successfully parsed, the parsed value is assigned to *offset if offset is not null. Format string The format string consists of zero or more conversion specifiers and ordinary characters. Each ordinary character, excluding whitespace characters and the terminating null character, matches one identical character from the input stream, or causes the function to fail if the next character on the stream does not compare equal. Each whitespace character matches zero or more whitespace characters in the input stream. Each unmodified conversion specifier begins with a % character followed by a character that determines the behavior of the specifier. Some conversion specifiers have a modified form in which an E or O modifier character is inserted after the % character. Some conversion specifiers have a modified form in which a width parameter given as a positive decimal integer (shown as N below) is inserted after the % character. Each conversion specifier causes the matched characters to be interpreted as parts of date and time types according to the table below. A character sequence in the format string that begins with a % but does not match one of the conversion specifiers below is interpreted as ordinary characters. If from_stream fails to parse everything specified by the format string, or if insufficient information is parsed to specify a complete result, or if parsing discloses contradictory information, is.setstate(std::ios_base::failbit) is called. The following conversion specifiers are available: Conversion Explanation specifier %% Matches a literal % character. %n Matches one whitespace character. %t Matches zero or one whitespace character. Year %C %NC Parses the century as a decimal number. The width N specifies the maximum number of characters to read. The default width is 2. Leading zeroes are permitted but not required. %EC The modified commands %EC and %OC interpret the locale’s alternative representation of the century. %OC %y %Ny Parses the last two decimal digits of the year. If the century is not otherwise specified (e.g. with %C), values in the range [69, 99] are presumed to refer to the years 1969 to 1999, and values in the range [00, 68] are presumed to refer to the years 2000 to 2068. The width N specifies the maximum number of characters to read. The default width is 2. Leading zeroes are permitted but not required. %Ey The modified commands %Ey and %Oy interpret the locale’s alternative representation. %Oy %Y Parses the year as a decimal number. The width N specifies the maximum number of characters to read. The default width is 4. Leading zeroes are permitted but not required. %NY The modified command %EY interprets the locale’s alternative representation. %EY Month %b %B Parses the locale’s full or abbreviated case-insensitive month name. %h %m Parses the month as a decimal number (January is 1). The width N specifies the maximum number of characters to read. The default width is 2. Leading zeroes are permitted but not required. %Nm The modified command %Om interprets the locale’s alternative representation. %Om Day %d %Nd %Ed Parses the day of month as a decimal number. The width N specifies the maximum number of characters to read. The default width is 2. Leading zeroes are permitted but not required. %e The modified commands %Ed and %Ee interpret the locale’s alternative representation. %Ne %Ee Day of the week %a Parses the locale’s full or abbreviated case-insensitive weekday name. %A %u Parses the ISO weekday as a decimal number (1-7), where Monday is 1. The width N specifies the maximum number of characters to read. The default width is 1. Leading zeroes are permitted but not required. %Nu The modified command %Ou interprets the locale’s alternative representation. %Ou %w Parses the weekday as a decimal number (0-6), where Sunday is 0. The width N specifies the maximum number of characters to read. The default width is 1. Leading zeroes are permitted but not required. %Nw The modified command %Ow interprets the locale’s alternative representation. %Ow ISO 8601 week-based year In ISO 8601 weeks begin with Monday and the first week of the year must satisfy the following requirements:

Miscellaneous

%c Parses the locale’s date and time representation. %Ec The modified command %Ec interprets the locale’s alternative date and time representation. %z Parses the offset from UTC in the format [+|-]hh[mm]. For example -0430 refers to 4 hours 30 minutes behind UTC and 04 refers to 4 hours ahead of UTC. %Ez The modified commands %Ez and %Oz parses the format [+|-]h[h][:mm] (i.e., requiring a : between the hours and minutes and making the leading zero for hour optional). %Oz %Z Parses the time zone abbreviation or name, taken as the longest sequence of characters that only contains the characters A through Z, a through z, 0 through 9, -, +, _, and /.

Return value

is.

Notes

This overload does not subtract the parsed offset (if any) from the parsed timestamp, unlike the from_stream overloads for the time_point of other clocks.

See also

parse parses a chrono object from a stream         (function template) (C++20)