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()。

使用完该线程后，请调用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)

将调用此设置器后创建的线程对象的服务质量级别设置为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 。否则，将立即使用一个可用线程运行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 。否则，将立即使用一个可用线程运行callableToRun ，并返回true 。

约束

仅当Callable 是可不带参数调用的函数或函数对象时，才参与重载解析。

bool QThreadPool::tryTake(QRunnable *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，则该函数将等待最后一个线程退出。