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

ループの本体では、以下のステップが行われます。

まず、 err = std::ios_base::goodbit を実行することによって err のエラービットをクリアします。 その後、 '%'、 modifier ('\0' でない場合) および format を組み合わせることによって形成される std::time_get の書式指定子によって期待される入力シーケンス [beg, end) から文字を読み込みます。 文字が有効な変換指定子を形成するために組み合わせられない場合は、 err に eofbit をセットします。 文字を読み込んだ後、入力ストリームの終端に達した場合は、 err に eofbit をセットします。 入力文字列の解析に成功した場合は、 *t の対応するフィールドを更新します。

'%x' や '%c' などの複雑な変換指定子や、修飾子 'E' および 'O' を使用する指令については、この関数は *t に格納する値のいくつかを決定するのに失敗するかもしれません。 そのような場合は、 err に eofbit をセットし、これらの状態を未規定な状態に置きます。

[編集] 引数

[編集] 戻り値

解析に成功した [beg, end) 内の最後の文字の次を指すイテレータ。

[編集] ノート

書式文字列内のホワイトスペースでなく '%' でない文字に対する大文字小文字を区別しない比較は、必ずではありませんが、一般的には、 str によって提供されるロケールの std::collate ファセットが使用されます。

解析エラーに遭遇した場合、この関数の多くの実装は *t にまったく触りません。

これらの関数が直接設定しない *t 内のフィールドをゼロクリアするかどうかは未規定です。 移植性のあるプログラムは get() を呼ぶ前にすべてのフィールドをゼロに初期化するべきです。

[編集] 例

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
 
int main()
{
    std::istringstream ss("2011-Februar-18 23:12:34");
    ss.imbue(std::locale("de_DE.utf8"));
 
    auto& f = std::use_facet<std::time_get<char>>(std::locale("de_DE.utf8"));
    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");
        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. Unparsed string: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
    std::cout << '\n';
}

Successfully parsed, as Sun Feb 18 23:12:34 2011 The input was fully consumed

[編集] 関連項目