std::chrono::from_stream (std::chrono::duration)

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

Пытается разобрать входной поток is в std::chrono::duration d, интерпретируемый как время суток, прошедшее с полуночи, в соответствии со строкой формата fmt.

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

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

Параметры

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

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

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

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

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

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

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

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

is

Пример

#include <chrono>
#include <iostream>
#include <locale>
#include <sstream>

int main()
{
    std::istringstream is{"18:14:21"};
    is.imbue(std::locale("en_US.utf-8"));
    std::chrono::hours hh{};
    std::chrono::from_stream(is, "%H:%M:%S", hh);
    is.fail() ? std::cout << "Parse failed!\n" : std::cout << hh.count() << '\n';
}

18

См. также