std::chrono:: parse

Возвращает объект 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++.

Смотрите также