std::chrono::from_stream (std::chrono::weekday)

Определено в заголовочном файле <chrono>

Определено в заголовочном файле `<chrono>`
template< class CharT, class Traits, class Alloc = std::allocator<CharT> > std::basic_istream<CharT, Traits>& from_stream( std::basic_istream<CharT, Traits>& is, const CharT* fmt, std::chrono::weekday& wd, std::basic_string<CharT, Traits, Alloc>* abbrev = nullptr, std::chrono::minutes* offset = nullptr );		(начиная с C++20)

template< class CharT, class Traits, class Alloc = std::allocator<CharT> >
std::basic_istream<CharT, Traits>&
    from_stream( std::basic_istream<CharT, Traits>& is, const CharT* fmt,
                 std::chrono::weekday& wd,
                 std::basic_string<CharT, Traits, Alloc>* abbrev = nullptr,
                 std::chrono::minutes* offset = nullptr );

(начиная с C++20)

Пытается разобрать входной поток is в std::chrono::weekday wd согласно строке формата fmt.

Ведёт себя как UnformattedInputFunction, за исключением того, что его влияние на is.gcount() не определено. После создания и проверки объекта sentry функция пытается разобрать входной поток is в wd согласно строке формата fmt. Если при разборе не удаётся декодировать допустимый weekday, вызывается is.setstate(std::ios_base::failbit), а wd не изменяется.

Если спецификатор формата %Z используется и успешно разобран, разобранное значение присваивается *abbrev, если abbrev не равен null. Если спецификатор формата %z или его модифицированный вариант используется и успешно разобран, разобранное значение присваивается *offset, если offset не равен null.

Параметры

is	-	входной поток
fmt	-	строка формата (см. ниже)
wd	-	объект для хранения результата разбора
abbrev	-	если не равен null, указатель на объект, который будет хранить аббревиатуру или название часового пояса, соответствующие спецификатору `%Z`
offset	-	если не равен null, указатель на объект, который будет хранить смещение относительно UTC, соответствующее спецификатору `%z`

Строка формата

Строка формата состоит из нуля или более спецификаторов преобразования и обычных символов. Каждый обычный символ, кроме пробельных символов и завершающего нулевого символа, соответствует такому же символу во входном потоке или приводит к сбою функции, если следующий символ в потоке не совпадает с ним.

Каждый пробельный символ соответствует нулю или более пробельным символам во входном потоке.

Каждый немодифицированный спецификатор преобразования начинается с символа %, за которым следует символ, определяющий поведение спецификатора. Некоторые спецификаторы преобразования имеют модифицированную форму, в которой после символа % вставляется модификатор E или O. Некоторые спецификаторы преобразования имеют модифицированную форму, в которой после символа % вставляется параметр ширины, заданный положительным десятичным целым числом (ниже обозначается как N). Каждый спецификатор преобразования предписывает интерпретировать соответствующие ему символы как части типов даты и времени согласно приведённой ниже таблице.

Последовательность символов в строке формата, начинающаяся с %, но не соответствующая ни одному из приведённых ниже спецификаторов преобразования, интерпретируется как обычные символы.

Если from_stream не удаётся разобрать всё, что задано строкой формата, если разобранной информации недостаточно для получения полного результата или если при разборе обнаруживаются противоречивые сведения, вызывается is.setstate(std::ios_base::failbit).

Доступны следующие спецификаторы преобразования:

Спецификатор преобразования	Описание
`%%`	Соответствует буквальному символу `%`.
`%n`	Соответствует одному пробельному символу.
`%t`	Соответствует нулю или одному пробельному символу.
Год
`%C` `%NC` `%EC`	Разбирает век как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%EC` интерпретирует альтернативное представление века в соответствии с локалью.
`%y` `%Ny` `%Ey` `%Oy`	Разбирает последние две десятичные цифры года. Если век не задан иным способом (например, с помощью %C), значения в диапазоне [69, 99] считаются годами с 1969 по 1999, а значения в диапазоне [00, 68] — годами с 2000 по 2068. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированные команды `%Ey` и `%Oy` интерпретируют альтернативное представление в соответствии с локалью.
`%Y` `%NY` `%EY`	Разбирает год как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 4. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%EY` интерпретирует альтернативное представление в соответствии с локалью.
Месяц
`%b` `%B` `%h`	Разбирает полное или сокращённое название месяца в соответствии с локалью без учёта регистра.
`%m` `%Nm` `%Om`	Разбирает месяц как десятичное число (январь — это `1`). Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%Om` интерпретирует альтернативное представление в соответствии с локалью.
День
`%d` `%Nd` `%Od` `%e` `%Ne` `%Oe`	Разбирает день месяца как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированные команды `%Od` и `%Oe` интерпретируют альтернативное представление в соответствии с локалью.
День недели
`%a` `%A`	Разбирает полное или сокращённое название дня недели в соответствии с локалью без учёта регистра.
`%u` `%Nu`	Разбирает день недели по ISO как десятичное число (1–7), где понедельник — это `1`. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 1. Ведущие нули разрешены, но не обязательны.
`%w` `%Nw` `%Ow`	Разбирает день недели как десятичное число (0–6), где воскресенье — это `0`. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 1. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%Ow` интерпретирует альтернативное представление в соответствии с локалью.
Год по неделям ISO 8601
В ISO 8601 недели начинаются с понедельника, а первая неделя года должна удовлетворять следующим требованиям: Включает 4 января Включает первый четверг года
`%g` `%Ng`	Разбирает последние две десятичные цифры года по неделям ISO 8601. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны.
`%G` `%NG`	Разбирает год по неделям ISO 8601 как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 4. Ведущие нули разрешены, но не обязательны.
`%V` `%NV`	Разбирает номер недели года по ISO 8601 как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны.
Неделя/день года
`%j` `%Nj`	Разбирает день года как десятичное число (1 января — это `1`). Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 3. Ведущие нули разрешены, но не обязательны.
`%U` `%NU` `%OU`	Разбирает номер недели года как десятичное число. Первое воскресенье года является первым днём недели 01. Дни того же года, предшествующие ему, относятся к неделе 00. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OU` интерпретирует альтернативное представление в соответствии с локалью.
`%W` `%NW` `%OW`	Разбирает номер недели года как десятичное число. Первый понедельник года является первым днём недели 01. Дни того же года, предшествующие ему, относятся к неделе 00. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OW` интерпретирует альтернативное представление в соответствии с локалью.
Дата
`%D`	Эквивалентно `"%m/%d/%y"`.
`%F` `%NF`	Эквивалентно `"%Y-%m-%d"`. Если ширина задана, она применяется только к `%Y`.
`%x` `%Ex`	Разбирает представление даты в соответствии с локалью. Модифицированная команда `%Ex` интерпретирует альтернативное представление даты в соответствии с локалью.
Время суток
`%H` `%NH` `%OH`	Разбирает час (в 24-часовом формате) как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OH` интерпретирует альтернативное представление в соответствии с локалью.
`%I` `%NI` `%OI`	Разбирает час (в 12-часовом формате) как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OI` интерпретирует альтернативное представление в соответствии с локалью.
`%M` `%NM` `%OM`	Разбирает минуты как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OM` интерпретирует альтернативное представление в соответствии с локалью.
`%S` `%NS` `%OS`	Разбирает секунды как десятичное число. Ширина N задаёт максимальное количество символов для чтения. Ширина по умолчанию равна 2. Ведущие нули разрешены, но не обязательны. Модифицированная команда `%OS` интерпретирует альтернативное представление в соответствии с локалью.
`%p`	Разбирает соответствующие локали обозначения AM/PM для 12-часового формата.
`%R`	Эквивалентно `"%H:%M"`.
`%T`	Эквивалентно `"%H:%M:%S"`.
`%r`	Разбирает время в 12-часовом формате в соответствии с локалью.
`%X` `%EX`	Разбирает представление времени в соответствии с локалью. Модифицированная команда `%EX` интерпретирует альтернативное представление времени в соответствии с локалью.
Разное
`%c` `%Ec`	Разбирает представление даты и времени в соответствии с локалью. Модифицированная команда `%Ec` интерпретирует альтернативное представление даты и времени в соответствии с локалью.
`%z` `%Ez` `%Oz`	Разбирает смещение относительно UTC в формате `[+\|-]hh[mm]`. Например, `-0430` означает 4 часа 30 минут к западу от UTC, а `04` — 4 часа к востоку от UTC. Модифицированные команды `%Ez` и `%Oz` разбирают формат `[+\|-]h[h][:mm]` (то есть требуют наличия `:` между часами и минутами и допускают отсутствие ведущего нуля в часах).
`%Z`	Разбирает аббревиатуру или название часового пояса как самую длинную последовательность символов, содержащую только символы от `A` до `Z`, от `a` до `z`, от `0` до `9`, `-`, `+`, `_` и `/`.

Возвращаемое значение

is

См. также

parse

(C++20)

разбирает объект chrono из потока
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/chrono/weekday/from_stream