QtTaskTree::ExecutableItem Class

メンバー関数のドキュメント

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withAccept(ObjectSignalGetter &&getter) const

this ExecutableItem のコピーを、シグナル・アウェイタと組み合わせて返します。渡されるgetter は、エミッタとその待機中のシグナルを表すObjectSignal を返す関数です。getter 内でmakeObjectSignal() を使用して、ObjectSignal オブジェクトを作成してください。

this ExecutableItem がエラーで終了した場合、返されるGroup は、アウェイタのシグナルを待機することなく、直ちにエラーで終了します。

this ExecutableItem が正常に終了した場合、返されたGroup は直ちに終了せず、待機中のシグナルが送信されるのを待ちます。待機中のシグナルが送信されると、返されたGroup は正常に終了します。this ExecutableItem が終了する前に待機中のシグナルが送信された場合、待機フェーズはスキップされ、返されたGroup は同期的に終了します。

待機対象のシグナルへの接続は、this ExecutableItem の実行が開始されようとする際に確立されます。待機対象のシグナルがそれ以前にトリガーされていた場合でも、this ExecutableItem の実行が開始された後は、その事実は認識されません。

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withCancel(ObjectSignalGetter &&getter, std::initializer_list<QtTaskTree::GroupItem> postCancelRecipe = {}) const

this ExecutableItem のコピーをキャンセル可能にします。引数として渡されるgetter は、エミッタとそのキャンセル信号を記述するObjectSignal を返す関数です。getter 内でmakeObjectSignal() を使用して、ObjectSignal オブジェクトを作成します。キャンセル信号が発行されると、this ExecutableItem はキャンセルされ、オプションで指定されたpostCancelRecipe が実行され、返された Group はエラー状態で終了します。

this ExecutableItem がキャンセル信号が発信される前に終了した場合、返される Group は、this ExecutableItem が終了したのと同じ結果で直ちに終了します。この場合、オプションで指定されたpostCancelRecipe はスキップされます。

キャンセル信号への接続は、this ExecutableItem が開始されようとしている時点で確立されます。以前にキャンセル信号がトリガーされていた場合、this ExecutableItem が開始された後は、その事実は認識されません。

QtTaskTree::Group ExecutableItem::withLog(const QString &logName) const

this ExecutableItem のコピーに、タスクの起動時およびタスク終了後に発行されるカスタムデバッグ出力情報を添付し、結合された項目を返します。

デバッグ出力には、イベント（開始または終了）のタイムスタンプと、デバッグログ内で特定のタスクを識別するためのlogName が含まれます。

終了時の出力には、実行が同期的か非同期的か、その結果（DoneWith 列挙型で記述される値）、および合計実行時間（ミリ秒単位）といった追加情報が含まれます。

QtTaskTree::Group ExecutableItem::withTimeout(std::chrono::milliseconds timeout, const std::function<void ()> &handler = {}) const

QTimeoutTask を、this ExecutableItem のコピーに結合します。この結合は、timeout からミリ秒単位で経過した時点、およびオプションで指定されたタイムアウトhandler に基づいて行われ、結合されたアイテムを返します。

ExecutableItem がtimeout が経過する前に完了した場合、返されるアイテムはタスクの結果と共に直ちに完了します。それ以外の場合、handler が呼び出され（指定されている場合）、タスクはキャンセルされ、返されるアイテムはエラーと共に完了します。