QThreadPool Class

class HelloWorldTask : public QRunnable
{
    void run() override
    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    }
};

HelloWorldTask *hello = new HelloWorldTask();
// QThreadPool takes ownership and deletes 'hello' automatically
QThreadPool::globalInstance()->start(hello);

メンバ関数 ドキュメント

QThreadPool::QThreadPool(QObject *parent = nullptr)

与えられたparent でスレッドプールを構築します。

[virtual noexcept] QThreadPool::~QThreadPool()

QThreadPoolこの関数は、すべての runnables が完了するまでブロックされます。

void QThreadPool::clear()

まだ開始されていない runnables をキューから削除する。runnable->autoDelete() がtrue を返す runnables は削除される。

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()も参照 。

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, QRunnable::if_callable<Callable> = true> void QThreadPool::start(Callable &&callableToRun, int priority = 0)

これはオーバーロードされた関数です。

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

[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, QRunnable::if_callable<Callable> = true> void QThreadPool::startOnReservedThread(Callable &&callableToRun)

これはオーバーロードされた関数です。

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

この関数は 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, QRunnable::if_callable<Callable> = true> bool QThreadPool::tryStart(Callable &&callableToRun)

これはオーバーロードされた関数である。

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

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

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 の場合、この関数は最後のスレッドの終了を待ちます。