QtTaskTree::When Class

メンバ関数ドキュメント

[explicit] When::When(const QtTaskTree::BarrierKickerGetter &kicker, QtTaskTree::WorkflowPolicy policy = WorkflowPolicy::StopOnError)

Do 本体と並行して実行されるExecutableItem を返すkicker を受け取り、遅延要素を作成する。kicker に渡されたQStoredBarrier が進むまで、Do 本体が遅延される。kicker とDo ボディが返すExecutableItem は、policy を使って並行して実行される。

例えば、QProcess が開始されるまで後続タスクの実行を遅らせたい場合、レシピは以下のようになる：

const auto kicker = [](const QStoredBarrier &barrier) {
    const auto onSetup = [barrier](QProcess &process) {
        QObject::connect(&process, &QProcess::started, barrier.activeStorage(), &QBarrier::advance);
        ... // Setup process program, arguments, environment, etc...
    };
    return QProcessTask(onSetup);
};

const Group recipe {
    When (kicker) >> Do {
        delayedTask1,
        ...
    }
};

上記のレシピが実行されると、QTaskTree は、Do 本体と並行してQProcessTask を実行する。Do 本体は、最初は保留状態である。キッカーに渡されたバリアが進んだ後、続行される。これは、QProcess が開始されるとすぐに起こる。それ以降、QProcess は、Do ボディと並行して実行される。

Doも参照のこと 。

[explicit] template < typename Task, typename Adapter, typename Deleter, typename Signal > When::When(const QtTaskTree::QCustomTask<Task, Adapter, Deleter> &customTask, Signal signal, QtTaskTree::WorkflowPolicy policy = QtTaskTree::WorkflowPolicy::StopOnError)

customTask 、およびそのTask'のsignal を、Do 本体と並列に実行する遅延要素を作成する。Do 本体は、Task'のsignal が発せられるまで遅延される。customTask とDo のボディは、policy を使って並列に実行される。

もう一方のWhenのコンストラクタのコードは次のように単純化できる：

const auto onSetup = [barrier](QProcess &process) {
    ... // Setup process program, arguments, environment, etc...
};

const Group recipe {
    When (QProcessTask(onSetup), &QProcess::started) >> Do {
        delayedTask1,
        ...
    }
};

Doも参照のこと 。