QtTaskTree::QThreadFunction Class

static void copyFile(QPromise<void> &promise, const QString &source,
                     const QString &destination)
{
    const QFileInfo fi(source);
    if (!fi.exists()) {
        promise.future().cancel(); // The QThreadFunction finishes with DoneResult::Error
        return;
    }

    // Copy file...
}

QThreadFunction<void> task;
task.setThreadFunctionData(copyFile, "source.txt", "dest.txt");
task.start();

メンバ関数ドキュメント

[default] QThreadFunction::QThreadFunction(QObject *parent = nullptr)

与えられたparent で QThreadFunction を構築します。

[override virtual] QThreadFunction::~QThreadFunction()

QThreadFunction QThreadFunction が実行中でない場合、他のアクションは実行されません。そうでない場合、関連するフューチャーはキャンセルされ、自動遅延同期に応じて以下のアクションが実行されます：

自動遅延同期がオンの場合、フューチャのキャンセルは別スレッドでまだ実行中の関数内でインターセプトされる可能性があります。

最後に、アプリケーションの終了時に、まだ別々のスレッドで実行されている可能性のあるすべての関数を同期させるために、QThreadFunctionBase::syncAll （）を呼び出す必要があります。QThreadFunctionBase::syncAll （）の呼び出しは、いくつかの関数がまだファイナライズ中である場合に備えてブロッキングされる。

setAutoDelayedSync() およびsyncAll()も参照 。

QFuture<ResultType> QThreadFunction::future() const

別スレッドで実行された関数に関連するQFuture<ResultType> を返す。

QFutureWatcher<ResultType> *QThreadFunction::futureWatcher()

別のスレッドで実行された関数に関連付けられたQFutureWatcher<ResultType> へのポインタを返します。返されたウォッチャーのライフタイムは、QThreadFunction インスタンスにバインドされます。

例えば、返されたウォッチャーのプログレス・シグナルに接続するなど、将来の実行をより制御する必要がある場合は、この関数を使用してください。

const QFutureWatcher<ResultType> *QThreadFunction::futureWatcher() const

別スレッドで実行された関数に関連するQFutureWatcher<ResultType> へのconst ポインタを返します。

bool QThreadFunction::isAutoDelayedSync() const

自動遅延同期がオンになっているかどうかを返します。

syncAll() およびsetAutoDelayedSync()も参照 。

bool QThreadFunction::isDone() const

関数の実行が終了したかどうかを返します。

bool QThreadFunction::isResultAvailable() const

結果が準備できているかどうかを返します。

result()も参照 。

ResultType QThreadFunction::result() const

別のスレッドで実行された関数によって報告された ResultType を返します。

QFutureWatcher::result()も参照のこと 。

ResultType QThreadFunction::resultAt(int index) const

index の別スレッドで実行された関数によって報告された ResultType を返す。

result() およびQFutureWatcher::resultAt()も参照のこと 。

QList<ResultType> QThreadFunction::results() const

別スレッドで実行された関数によって報告された ResultType のリストを返す。

result()、resultAt()、QFuture::results()も参照 。

void QThreadFunction::setAutoDelayedSync(bool on)

自動遅延同期をon に設定します。

デフォルトでは、自動遅延同期はオンになっています。つまり、実行中のQThreadFunction オブジェクトの破棄は、別のスレッドで実行されている関数が終了するまでブロックされません。その代わり、関連するQFuture はキャンセルされ、関数は終了するまで実行されたままになります。このキャンセルは、QPromise 引数を介して別のスレッドで実行されている関数によって傍受される可能性があるため、仕事を完了することなく早期に終了する可能性があります。自動遅延同期がオンの場合、別々のスレッドで実行されている可能性のある関数をすべて同期させるために、アプリケーション終了時にQThreadFunctionBase::syncAll （）を呼び出す必要があります。

自動遅延同期がオフの場合、QThreadFunction の破棄時に同期が行われ、呼び出し元のスレッドがかなりの時間ブロックされる可能性があります。

自動同期は、QThreadFunction がメインスレッドから実行された場合にのみ使用される。

syncAll() およびisAutoDelayedSync()も参照のこと 。

template <typename Function, typename... Args> void QThreadFunction::setThreadFunctionData(Function &&function, Args &&... args)

start() が呼び出されたときに、別のスレッドで渡されたargs で実行されるfunction を設定します。

QtConcurrent::run()も参照してください 。

void QThreadFunction::setThreadPool(QThreadPool *pool)

呼び出しの実行時に使用するQThreadPool pool を設定する。渡されたpool がnullptr の場合、QThreadPool::globalInstance() が使用される。

threadPool()も参照のこと 。

ResultType QThreadFunction::takeResult() const

別のスレッドで実行された関数によって報告された ResultType を取得（移動）します。

QFuture::takeResult()も参照 。

QThreadPool *QThreadFunction::threadPool() const

呼び出しの実行時に使用されるスレッド・プールを返す。nullptr が返された場合は、QThreadPool::globalInstance() が使用される。

setThreadPool()も参照のこと 。