QThreadPool 类

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。该函数将阻塞直到所有可运行的任务都已完成。

void QThreadPool::clear()

从队列中删除尚未启动的可运行任务。对于返回 true 的runnable->autoDelete() 的可运行任务进行删除。

参见 start。

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

如果 thread 是此线程池管理的线程，则返回 true。

此函数是在 Qt 6.0 中引入的。

[静态] QThreadPool *QThreadPool::globalInstance()

返回全局 QThreadPool 实例。

void QThreadPool::releaseThread()

释放由 reserveThread() 调用之前预留的线程。

另请参阅：reserveThread。

void QThreadPool::reserveThread()

预留一个线程，不考虑 activeThreadCount 和 maxThreadCount。

完成对该线程的使用后，调用 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()。

[自 6.3] 模板 <typename Callable, QRunnable::if_callable<Callable> = true> void QThreadPool::startOnReservedThread(Callable &&callableToRun)

这是重载函数。

使用 reserveThread() 释放之前保留的线程，并使用它来运行 callableToRun。

此函数自 Qt 6.3 中引入。

bool QThreadPool::tryStart(QRunnable *runnable)

尝试为运行 runnable 保留线程。

如果在调用时没有线程可用，则此函数不执行任何操作并返回 false。否则，将立即使用一个可用的线程运行 runnable，并返回 true。

注意：在成功的情况下，如果 runnable->autoDelete() 返回 true，线程池将获取 runnable 的所有权，并且在 runnable->run() 返回后，线程池将自动删除该Runnable。如果 runnable->autoDelete() 返回 false，则所有权保留在调用者处。请注意，在调用此函数后更改 runnable 的自动删除行为会导致未定义行为。