std::chrono::parse

template< class CharT, class Parsable >
/* unspecified */ parse( const CharT* fmt, Parsable& tp );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const std::basic_string<CharT, Traits, Alloc>& fmt,
                         Parsable& tp );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const CharT* fmt, Parsable& tp,
                         std::basic_string<CharT, Traits, Alloc>& abbrev );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const std::basic_string<CharT, Traits, Alloc>& fmt,
                         Parsable& tp,
                         std::basic_string<CharT, Traits, Alloc>& abbrev );

template< class CharT, class Parsable >
/* unspecified */ parse( const CharT* fmt, Parsable& tp,
                         std::chrono::minutes& offset );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const std::basic_string<CharT, Traits, Alloc>& fmt,
                         Parsable& tp, std::chrono::minutes& offset );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const CharT* fmt, Parsable& tp,
                         std::basic_string<CharT, Traits, Alloc>& abbrev,
                         std::chrono::minutes& offset );

template< class CharT, class Traits, class Alloc, class Parsable >
/* unspecified */ parse( const std::basic_string<CharT, Traits, Alloc>& fmt,
                         Parsable& tp,
                         std::basic_string<CharT, Traits, Alloc>& abbrev,
                         std::chrono::minutes& offset );

Возвращает объект manip неуказанного типа, такой что для объекта std::basic_istream<CharT, Traits> is выражение is >> manip вызывает from_stream (без квалификатора, чтобы обеспечить поиск, зависящий от аргументов) следующим образом:

Выражение is >> manip является lvalue типа std::basic_istream<CharT, Traits> со значением is.

Эти перегрузки участвуют в разрешении перегрузки, только если соответствующее выражение from_stream является корректным.

Рекомендуется, чтобы реализации затрудняли использование потенциально висячих ссылок на строку формата, например, делая возвращаемые типы неперемещаемыми и запрещая operator>> принимать lvalue возвращаемых типов.

Параметры

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

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

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

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

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

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

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

Пример

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

int main()
{
    auto parse = [&](auto str, auto fmt, auto o)
    {
        std::istringstream is{str};
        is.imbue(std::locale("en_US.utf-8"));
        is >> std::chrono::parse(fmt, o);
        is.fail() ? std::cout << "Parse failed!\n" : std::cout << o << '\n';
    };
    parse("01:02:03", "%H:%M:%S", std::chrono::hours{});
    parse("01:02:03", "%H:%M:%S", std::chrono::minutes{});
    parse("01:02:03", "%H:%M:%S", std::chrono::seconds{});
}

1h
62min
3723s

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

См. также