QThreadPool Class

classHelloWorldTask :publicQRunnable
{
    voidrun() override
    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    }
};

intmain()
{
    //...
    HelloWorldTask*hello = newHelloWorldTask();
    // QThreadPool が 'hello' の所有権を引き継ぎ、自動的に削除します
    QThreadPool::globalInstance()->start(hello);
    //...
}

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

QThreadPool::QThreadPool(QObject *parent = nullptr)

指定されたparent を使用して、スレッドプールを構築します。

[virtual noexcept] QThreadPool::~QThreadPool()

QThreadPool を破棄します。この関数は、すべての実行可能オブジェクトが完了するまでブロックされます。

void QThreadPool::clear()

まだ開始されていない実行可能オブジェクトをキューから削除します。runnable->autoDelete() の戻り値が `true ` となる実行可能オブジェクトが削除されます。

start()も参照してください 。

[since 6.0] bool QThreadPool::contains(const QThread *thread) const

thread がこのスレッドプールによって管理されているスレッドである場合、true を返します。

この関数は Qt 6.0 で導入されました。

[static] QThreadPool *QThreadPool::globalInstance()

グローバルなQThreadPool インスタンスを返します。

void QThreadPool::releaseThread()

reserveThread() の呼び出しによって以前に予約されていたスレッドを解放します。

reserveThread()も参照してください 。

void QThreadPool::reserveThread()

activeThreadCount() およびmaxThreadCount() を無視して、スレッドを1つ予約します。

スレッドの使用が終了したら、releaseThread() を呼び出して、そのスレッドが再利用できるようにします。

releaseThread()も参照してください 。

[since 6.9] QThread::QualityOfService QThreadPool::serviceLevel() const

スレッドの現在のサービス品質（QoS）レベルを返します。

この関数は Qt 6.9 で導入されました。

setServiceLevel() およびQThread::serviceLevel()も参照してください 。

[since 6.9] void QThreadPool::setServiceLevel(QThread::QualityOfService serviceLevel)

このセッターの呼び出し後に作成されるスレッドオブジェクトのサービス品質（QoS）レベルをserviceLevel に設定します。

すべてのプラットフォームでサポートされているわけではありません。詳細については、QThread::setServiceLevel() を参照してください。

この関数は Qt 6.9 で導入されました。

serviceLevel() およびQThread::serviceLevel()も参照してください 。

void QThreadPool::start(QRunnable *runnable, int priority = 0)

スレッドを予約し、それを使用して `runnable` を実行します。ただし、このスレッドによって現在のスレッド数が `maxThreadCount()` を超える場合は除きます。その場合は、代わりに `runnable ` が実行キューに追加されます。引数 `priority ` を使用することで、実行キュー内の実行順序を制御できます。

runnable->autoDelete() がtrue を返した場合、スレッドプールがrunnable の所有権を取得することに注意してください。また、runnable->run() が返った後、runnable はスレッドプールによって自動的に削除されます。runnable->autoDelete() がfalse を返した場合、runnable の所有権は呼び出し元に留まります。なお、この関数の呼び出し後にrunnable の自動削除設定を変更すると、未定義の挙動となることに注意してください。

template <typename Callable> requires QRunnable::if_callable<Callable> void QThreadPool::start(Callable &&callableToRun, int priority = 0)

スレッドを予約し、それを使用してcallableToRun を実行します。ただし、このスレッドによって現在のスレッド数がmaxThreadCount()を超えてしまう場合は除きます。その場合は、代わりにcallableToRun が実行キューに追加されます。引数priority を使用することで、実行キュー内の実行順序を制御できます。

制約

Callable が引数なしで呼び出せる関数または関数オブジェクトである場合にのみ、オーバーロード解決の対象となります。

[since 6.3] void QThreadPool::startOnReservedThread(QRunnable *runnable)

reserveThread() で以前に予約されたスレッドを解放し、そのスレッドを使用してrunnable を実行します。

runnable->autoDelete()がtrue を返した場合、スレッドプールがrunnable の所有権を取得し、runnable->run()の戻り値が返された後、runnable はスレッドプールによって自動的に削除されることに注意してください。runnable->autoDelete()がfalse を返した場合、runnable の所有権は呼び出し元に留まります。この関数の呼び出し後にrunnable の自動削除設定を変更すると、未定義の挙動を引き起こすことに注意してください。

この関数は Qt 6.3 で導入されました。

reserveThread() およびstart()も参照してください 。

[since 6.3] template <typename Callable> requires QRunnable::if_callable<Callable> void QThreadPool::startOnReservedThread(Callable &&callableToRun)

reserveThread() で以前に予約されたスレッドを解放し、そのスレッドを使用してcallableToRun を実行します。

制約

Callable が引数なしで呼び出せる関数または関数オブジェクトである場合にのみ、オーバーロード解決の対象となります。

この関数は Qt 6.3 で導入されました。

bool QThreadPool::tryStart(QRunnable *runnable)

runnable を実行するためのスレッドを予約しようとします。

呼び出し時に利用可能なスレッドがない場合、この関数は何も行わず、false を返します。それ以外の場合は、利用可能なスレッドの1つを使用してrunnable が直ちに実行され、この関数はtrue を返します。

成功した場合、runnable->autoDelete() がtrue を返すと、スレッドプールがrunnable の所有権を取得し、runnable->run() が返った後、runnable はスレッドプールによって自動的に削除されます。runnable->autoDelete() がfalse を返した場合、runnable の所有権は呼び出し元に留まります。なお、この関数の呼び出し後にrunnable の自動削除設定を変更すると、未定義の挙動を引き起こすことに注意してください。

template <typename Callable> requires QRunnable::if_callable<Callable> bool QThreadPool::tryStart(Callable &&callableToRun)

callableToRun を実行するためのスレッドを予約しようとします。

呼び出し時に利用可能なスレッドがない場合、この関数は何もしないでfalse を返します。それ以外の場合は、利用可能なスレッドの 1 つを使用してcallableToRun が直ちに実行され、この関数はtrue を返します。

制約

Callable が引数なしで呼び出せる関数または関数オブジェクトである場合にのみ、オーバーロード解決の対象となります。

bool QThreadPool::tryTake(QRunnable *runnable)

指定されたrunnable がまだ開始されていない場合、キューからそれを削除しようと試みます。runnableがまだ開始されていなかった場合、true を返し、runnable の所有権は呼び出し元に譲渡されます（runnable->autoDelete() == true の場合でも同様です）。それ以外の場合は、false を返します。

start() およびQRunnable::autoDelete()も参照してください 。

[since 6.8] bool QThreadPool::waitForDone(QDeadlineTimer deadline = QDeadlineTimer::Forever)

deadline が期限切れになるまで待機し、すべてのスレッドが終了した後、スレッドプールからすべてのスレッドを削除します。すべてのスレッドが削除された場合はtrue を返し、そうでない場合はfalse を返します。

この関数は Qt 6.8 で導入されました。

bool QThreadPool::waitForDone(int msecs)

すべてのスレッドが終了するまで最大msecs ミリ秒待機し、スレッドプールからすべてのスレッドを削除します。すべてのスレッドが削除された場合はtrue を返し、そうでない場合はfalse を返します。msecs が-1の場合、この関数は最後のスレッドが終了するまで待機します。