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 を組み合わせて形成される）で期待される形式を解析します。文字が有効な変換指定子を形成しない場合、 err に failbit を設定します。文字を読み込んだ後に入力ストリームの終端に達した場合、 err に eofbit を設定します。入力文字列が正常に解析された場合、 * t の対応するフィールドを更新します。

複雑な変換指定子、例えば '%x' や '%c' 、または修飾子 'E' および 'O' を使用するディレクティブの場合、関数は * t に格納する値の一部を決定できない可能性があります。そのような場合、関数は eofbit を err に設定し、これらのフィールドを未指定の状態のままにします。

パラメータ

書式文字列は、ゼロ個以上の変換指定子、空白文字、および通常の文字（ % を除く）で構成されます。各通常の文字は、大文字小文字を区別しない比較で入力ストリーム内の1文字と一致することが期待されます。各空白文字は、入力文字列内の任意の空白と一致します。各変換指定は % 文字で始まり、オプションで E または O 修飾子（ロケールでサポートされていない場合は無視される）が続き、その後に指定子の動作を決定する文字が続きます。書式指定子はPOSIX関数 strptime() と一致します：

注記: tm_isdst は書き込まれず、 mktime などの関数で使用するには明示的に設定する必要があります。

戻り値

正常に解析された最後の文字の次の位置を指すイテレータ。 [ beg, end ) の範囲内で。

注記

書式文字列内の空白文字および '%' 以外の文字に対する大文字小文字を区別しない比較には、 str によって提供されるロケールの std::collate ファセットが通常（必ずしもそうとは限らないが）使用されます。

構文解析エラーが発生した場合、この関数の多くの実装では * 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.

関連項目