std::time_get<CharT,InputIt>:: get, std::time_get<CharT,InputIt>:: do_get

В теле цикла выполняются следующие шаги:

Сначала очищает биты ошибок в err выполняя err = std:: ios_base :: goodbit . Затем читает символы из входной последовательности [ beg, end ) соответствующие спецификатору формата std::time_get сформированному комбинацией '%' , modifier (если не ' \0 ' ) и format . Если символы не образуют допустимый спецификатор преобразования, устанавливает failbit в err . Если конец входного потока достигается после чтения символа, устанавливает eofbit в err . Если входная строка успешно разобрана, обновляет соответствующие поля * t .

Для сложных спецификаторов преобразования, таких как '%x' или '%c' , или директив, использующих модификаторы 'E' и 'O' , функция может не определить некоторые значения для сохранения в * t . В таком случае она устанавливает eofbit в err и оставляет эти поля в неопределенном состоянии.

Параметры

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

Примечание: tm_isdst не записывается и должно быть установлено явно для использования с функциями такими как mktime

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

Итератор, указывающий на позицию за последним символом в [ beg, end ) , который был успешно распарсен.

Примечания

Без учета регистра сравнение для не-пробельных не- '%' символов в строке формата, обычно, но не обязательно, используется фасет std::collate локали, предоставленной str .

Если возникает ошибка синтаксического анализа, многие реализации этой функции оставляют * t полностью нетронутым.

Не определено, обнуляют ли эти функции поля в * t , которые они не устанавливают напрямую: переносимые программы должны инициализировать каждое поле нулём перед вызовом get() .

Пример

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    std::istringstream ss("2026-März-12 23:45:56");
    ss.imbue(std::locale("de_DE.utf8"));
    auto& f = std::use_facet<std::time_get<char>>(ss.getloc());
    std::tm t{};
    std::string s = "%Y-%b-%d %H:%M:%S";
    std::ios_base::iostate err = std::ios_base::goodbit;
    auto ret = f.get({ss}, {}, ss, err, &t, &s[0], &s[0] + s.size());
    ss.setstate(err);
    std::istreambuf_iterator<char> last{};
    if (ss)
    {
        std::cout << "Successfully parsed as " << std::put_time(&t, "%c") << '\n';
        if (ret != last)
        {
            std::cout << "Remaining content: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << "The input was fully consumed.";
    }
    else
    {
        std::cout << "Parse failed.\nUnparsed string: ";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
    std::cout << '\n';
}

Successfully parsed as Sun Mar 12 23:45:56 2026
The input was fully consumed.

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