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

public:
iter_type get( iter_type beg, iter_type end, std::ios_base& str,
               std::ios_base::iostate& err, std::tm* t,
               char format, char modifier = 0 ) const;

public:
iter_type get( iter_type beg, iter_type end, std::ios_base& str,
               std::ios_base::iostate& err, std::tm* t,
               const char_type* fmtbeg, const char_type* fmtend ) const;

protected:
virtual iter_type do_get( iter_type beg, iter_type end, std::ios_base& str,
                          std::ios_base::iostate& err, std::tm *t,
                          char format, char modifier ) const;

Параметры

Строка формата состоит из нуля или более спецификаторов преобразования, пробельных символов и обычных символов (кроме %). Каждый обычный символ должен соответствовать одному символу входного потока при сравнении без учёта регистра. Каждый пробельный символ соответствует произвольному количеству пробельных символов во входной строке. Каждая спецификация преобразования начинается с символа %, за которым может следовать модификатор 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.

См. также