std::chrono::from_stream (std::chrono::year_month)

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::year_month& ym,
                 std::basic_string<CharT, Traits, Alloc>* abbrev = nullptr,
                 std::chrono::minutes* offset = nullptr );

Пытается разобрать входной поток is в std::chrono::year_month ym в соответствии со строкой формата fmt.

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

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

Параметры

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

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

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

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

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

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

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

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

is

См. также