【MQL5】FrameFirst関数について

bool FrameFirst();

// 最適化の各パスで新しいフレームが到着した際に自動的に呼び出される関数
void OnTesterPass()
{
    // フレームのパスIDを格納するための変数。最適化の各パス（試行）ごとに一意のIDが付与される
    ulong pass_id;

    // フレームの名前を格納するための変数。FrameAdd関数を使って送信される際に設定された名前が入る
    string frame_name;

    // フレームの識別IDを格納する変数。FrameAdd関数で設定した識別番号が保持される
    long frame_id;

    // フレームの値（数値データ）を格納するための変数。FrameAddで指定された数値情報が入る
    double frame_value;

    // FrameNext関数は、次のフレームが存在する限りtrueを返し、フレームデータを変数に格納する
    // フレームがなくなるまでループを継続
    while(FrameNext(pass_id, frame_name, frame_id, frame_value))
    {
        // 取得したフレームデータをエキスパートログに出力
        // Print関数を使用し、Pass ID、フレーム名、識別ID、値の情報を表示
        Print("Pass ID: ", pass_id,           // 最適化のパスIDを表示
              " Name: ", frame_name,          // フレームの名前を表示
              " ID: ", frame_id,              // フレームの識別IDを表示
              " Value: ", DoubleToString(frame_value, 2)); // 数値データを小数点2桁で表示
    }
}

// 最適化が終了した後に未処理のフレームを処理するための関数
void OnTesterDeinit()
{
    // 最適化パスID、フレーム名、識別ID、値を保持する変数を定義
    ulong pass_id;
    string frame_name;
    long frame_id;
    double frame_value;

    // FrameFirst関数を呼び出してフレームの最初の位置に移動
    // 最適化完了後、すべてのフレームを再確認する準備を行う
    FrameFirst();

    // 未処理のフレームがある限り、次のフレームを取得して処理を繰り返す
    while(FrameNext(pass_id, frame_name, frame_id, frame_value))
    {
        // 未処理のフレームデータをエキスパートログに出力して確認
        Print("Deinit - Pass ID: ", pass_id,        // 最適化パスIDを表示
              " Name: ", frame_name,               // フレームの名前を表示
              " ID: ", frame_id,                   // フレームの識別IDを表示
              " Value: ", DoubleToString(frame_value, 2)); // 数値データを小数点2桁で表示
    }
}