QtTaskTree::ExecutableItem Class

メンバ関数ドキュメント

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

this ExecutableItem のコピーとシグナル待機器を結合したものを返す。渡されたgetter は、エミッタとそのシグナル待ちを記述したObjectSignal を返す関数です。ObjectSignal オブジェクトを作成するには、getter 内でmakeObjectSignal() を使用します。

this ExecutableItem がエラーで終了した場合、返されたGroup は、awaiter のシグナルを待たずに、直ちにエラーで終了します。

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 を返す関数です。ObjectSignal オブジェクトを作成するには、getter 内でmakeObjectSignal() を使用します。キャンセルシグナルが発せられると、this ExecutableItem がキャンセルされ、オプションで提供されるpostCancelRecipe が実行され、return Group はエラーで終了する。

キャンセルシグナルが発せられる前にthis ExecutableItem が終了すると、返された Group はthis ExecutableItem が終了したのと同じ結果で直ちに終了する。この場合、オプションで提供されるpostCancelRecipe はスキップされる。

キャンセルシグナルへの接続は、this ExecutableItem が開始されようとするときに確立される。this ExecutableItem が開始された後、キャンセルシグナルが以前にトリガーされた場合、このことに気づくことはない。

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

タスク起動時とタスク終了後に発行されるthis ExecutableItem のコピーにカスタムデバッグプリントアウトをアタッチし、結合されたアイテムを返す。

デバッグ・プリントアウトには、イベントのタイムスタンプ (開始または終了) と、デバッグ・ログで特定のタスクを識別するためのlogName が含まれます。

finish printout には、実行が同期か非同期か、その結果（DoneWith enum で記述された値）、およびミリ秒単位の総実行時間という追加情報が含まれます。

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

this ExecutableItem のコピーにQTimeoutTask をアタッチし、timeout の後にミリ秒単位で経過し、オプションで提供されるタイムアウトhandler で、結合されたアイテムを返す。

timeout が通過する前にExecutableItem が終了すると、返されたアイテムはタスクの結果と共に直ちに終了する。そうでない場合、handler が呼び出され (指定された場合)、タスクはキャンセルされ、返されたアイテムはエラーで終了します。