QThreadPool Class

类HelloWorldTask :公有QRunnable
{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() 。

使用完线程后，请调用releaseThread() 以允许其被重复使用。

另请参见 releaseThread()。

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

返回线程的当前服务质量级别。

此函数在 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, QRunnable::if_callable<Callable> = true> 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, QRunnable::if_callable<Callable> = true> 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, QRunnable::if_callable<Callable> = true> bool QThreadPool::tryStart(Callable &&callableToRun)

这是一个重载函数。

它试图保留一个运行callableToRun 的线程。

如果调用时没有可用线程，则该函数不会执行任何操作，并返回false 。否则，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，则该函数等待最后一个线程退出。