QThreadPool Class

クラスHelloWorldTask :publicQRunnable
{voidrun() オーバーライド    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    } }; 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()も参照のこと 。

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