std::get_time

式 in >> get_time(tmb, fmt) で使用されたとき、入力ストリーム in に現在設定されているロケールの std::time_get ファセットに従って書式文字列 fmt に従って日付時刻値として文字入力を解析します。 結果の値は tmb の指す std::tm オブジェクトに格納されます。

[編集] 引数

[編集] 戻り値

in が std::basic_istream<CharT, Traits> 型の入力ストリームの名前である場合に式 in >> get_time(tmb, fmt) が以下のコードが実行されたかのように動作するような、未規定な型のオブジェクトを返します。

typedef std::istreambuf_iterator<CharT, Traits> Iter;
typedef std::time_get<CharT, Iter> TimeGet;
std::ios_base::iostate err = std::ios_base::goodbit;
const TimeGet& tg = std::use_facet<TimeGet>(in.getloc());
tg.get(Iter(in.rdbuf()), Iter(), in, err, tmb, fmt, fmt + traits::length(fmt));
if (err != std::ios_base::goodbit)
    in.setstate(err);

[編集] ノート

この関数が呼ぶ std::time_get::do_get で規定されているように、 fmt に現れる変換指定子によって直接設定されない *tmb のフィールドがゼロクリアされるかどうかは未規定です。 移植性のあるプログラムは std::get_time を呼ぶ前に *tmb のすべてのフィールドをゼロに初期化するべきです。

[編集] 例

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
 
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

[編集] 関連項目