std::get_time

template< class CharT >
/*unspecified*/ get_time( std::tm* tmb, const CharT* fmt );

При использовании в выражении in >> get_time(tmb, fmt) разбирает символьный ввод как значение даты и времени согласно строке формата fmt и фасету std::time_get локали, установленной для входного потока in. Полученное значение сохраняется в объекте std::tm, на который указывает tmb.

Параметры

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

Объект неуказанного типа, такой что

• если in является объектом типа std::basic_istream<CharT, Traits>, выражение in >> get_time(tmb, fmt)
  • имеет тип std::basic_istream<CharT, Traits>&
  • имеет значение in
  • ведёт себя так, как если бы вызывало f(in, tmb, fmt)

где функция f определена следующим образом:

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, std::tm* tmb, const CharT* fmt)
{
    using Iter = std::istreambuf_iterator<CharT, Traits>;
    using TimeGet = time_get<CharT, Iter>;
    
    std::ios_base::iostate err = std::ios_base::goodbit;
    const TimeGet& tg = std::use_facet<TimeGet>(str.getloc());
    
    tg.get(Iter(str.rdbuf()), Iter(), str, err, tmb,
        fmt, fmt + Traits::length(fmt));
    
    if (err != std::ios_base::goodbit)
        str.setstate(err);
}

Примечания

Согласно спецификации std::time_get::do_get, которую вызывает эта функция, не определено, обнуляет ли она поля в *tmb, которые явно не устанавливаются спецификаторами преобразования, присутствующими в fmt: переносимые программы должны инициализировать каждое поле *tmb нулём перед вызовом std::get_time.

Пример

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>

int main()
{
    std::tm t = {};
    std::istringstream ss("2011-Februar-18 23:12:34");
    ss.imbue(std::locale("de_DE.utf-8"));
    ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
    
    if (ss.fail())
        std::cout << "Parse failed\n";
    else
        std::cout << std::put_time(&t, "%c") << '\n';
}

Sun Feb 18 23:12:34 2011

См. также