QThreadPool Class

class HelloWorldTask : public QRunnable
{ void run() override    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    } }; HelloWorldTask *hello = new HelloWorldTask();// QThreadPool übernimmt den Besitz und löscht 'hello' automatischQThreadPool::globalInstance()->start(hello);

Dokumentation der Mitgliedsfunktionen

QThreadPool::QThreadPool(QObject *parent = nullptr)

Konstruiert einen Thread-Pool mit der angegebenen parent.

[virtual noexcept] QThreadPool::~QThreadPool()

Zerstört die QThreadPool. Diese Funktion blockiert, bis alle Runnables abgeschlossen sind.

void QThreadPool::clear()

Entfernt die Runnables, die noch nicht gestartet sind, aus der Warteschlange. Die Runnables, für die runnable->autoDelete() true zurückgibt, werden gelöscht.

Siehe auch start().

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

Gibt true zurück, wenn thread ein Thread ist, der von diesem Threadpool verwaltet wird.

Diese Funktion wurde in Qt 6.0 eingeführt.

[static] QThreadPool *QThreadPool::globalInstance()

Gibt die globale Instanz QThreadPool zurück.

void QThreadPool::releaseThread()

Gibt einen Thread frei, der zuvor durch einen Aufruf von reserveThread() reserviert wurde.

Siehe auch reserveThread().

void QThreadPool::reserveThread()

Reserviert einen Thread, ohne Rücksicht auf activeThreadCount() und maxThreadCount().

Sobald Sie mit dem Thread fertig sind, rufen Sie releaseThread() auf, damit er wieder verwendet werden kann.

Siehe auch releaseThread().

void QThreadPool::start(QRunnable *runnable, int priority = 0)

Reserviert einen Thread und verwendet ihn zur Ausführung von runnable, es sei denn, dieser Thread führt dazu, dass die aktuelle Thread-Anzahl maxThreadCount() überschreitet. In diesem Fall wird runnable stattdessen zu einer Warteschlange hinzugefügt. Das Argument priority kann verwendet werden, um die Reihenfolge der Ausführung in der Warteschlange zu steuern.

Beachten Sie, dass der Thread-Pool das Eigentum an runnable übernimmt, wenn runnable->autoDelete() true zurückgibt, und dass runnable automatisch vom Thread-Pool gelöscht wird, nachdem runnable->run() zurückgekehrt ist. Wenn runnable->autoDelete() false zurückgibt, bleibt das Eigentum an runnable beim Aufrufer. Beachten Sie, dass eine Änderung der automatischen Löschung auf runnable nach dem Aufruf dieser Funktion zu undefiniertem Verhalten führt.

template <typename Callable, QRunnable::if_callable<Callable> = true> void QThreadPool::start(Callable &&callableToRun, int priority = 0)

Dies ist eine überladene Funktion.

Reserviert einen Thread und verwendet ihn, um callableToRun auszuführen, es sei denn, dieser Thread führt dazu, dass die aktuelle Threadanzahl maxThreadCount() überschreitet. In diesem Fall wird callableToRun stattdessen zu einer Warteschlange hinzugefügt. Das Argument priority kann verwendet werden, um die Reihenfolge der Ausführung in der Warteschlange zu steuern.

[since 6.3] void QThreadPool::startOnReservedThread(QRunnable *runnable)

Gibt einen zuvor mit reserveThread() reservierten Thread frei und verwendet ihn zur Ausführung von runnable.

Beachten Sie, dass der Thread-Pool das Eigentum an runnable übernimmt, wenn runnable->autoDelete() true zurückgibt, und dass runnable automatisch vom Thread-Pool gelöscht wird, nachdem runnable->run() zurückgekehrt ist. Wenn runnable->autoDelete() false zurückgibt, bleibt das Eigentum an runnable beim Aufrufer. Beachten Sie, dass das Ändern der automatischen Löschung auf runnable nach dem Aufruf dieser Funktion zu undefiniertem Verhalten führt.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch reserveThread() und start().

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

Dies ist eine überladene Funktion.

Gibt einen zuvor mit reserveThread() reservierten Thread frei und verwendet ihn zur Ausführung von callableToRun.

Diese Funktion wurde in Qt 6.3 eingeführt.

bool QThreadPool::tryStart(QRunnable *runnable)

Versucht, einen Thread für die Ausführung von runnable zu reservieren.

Wenn zum Zeitpunkt des Aufrufs keine Threads verfügbar sind, tut diese Funktion nichts und gibt false zurück. Andernfalls wird runnable sofort unter Verwendung eines verfügbaren Threads ausgeführt und diese Funktion gibt true zurück.

Beachten Sie, dass bei Erfolg der Thread-Pool das Eigentum an runnable übernimmt, wenn runnable->autoDelete() true zurückgibt, und dass runnable automatisch vom Thread-Pool gelöscht wird, nachdem runnable->run() zurückgekehrt ist. Wenn runnable->autoDelete() false zurückgibt, bleibt das Eigentum an runnable beim Aufrufer. Beachten Sie, dass das Ändern der automatischen Löschung auf runnable nach dem Aufruf dieser Funktion zu undefiniertem Verhalten führt.

template <typename Callable, QRunnable::if_callable<Callable> = true> bool QThreadPool::tryStart(Callable &&callableToRun)

Dies ist eine überladene Funktion.

Versucht, einen Thread für die Ausführung von callableToRun zu reservieren.

Wenn zum Zeitpunkt des Aufrufs keine Threads verfügbar sind, tut diese Funktion nichts und gibt false zurück. Andernfalls wird callableToRun sofort unter Verwendung eines verfügbaren Threads ausgeführt und diese Funktion gibt true zurück.

bool QThreadPool::tryTake(QRunnable *runnable)

Versucht, das angegebene runnable aus der Warteschlange zu entfernen, wenn es noch nicht gestartet ist. Wenn die Runnable noch nicht gestartet wurde, wird true zurückgegeben, und das Eigentum an runnable wird an den Aufrufer übertragen (auch wenn runnable->autoDelete() == true). Andernfalls wird false zurückgegeben.

Siehe auch start() und QRunnable::autoDelete().

[since 6.8] bool QThreadPool::waitForDone(QDeadlineTimer deadline = QDeadlineTimer::Forever)

Wartet, bis deadline abläuft, damit alle Threads beendet werden können, und entfernt alle Threads aus dem Thread-Pool. Gibt true zurück, wenn alle Threads entfernt wurden; andernfalls wird false zurückgegeben.

Diese Funktion wurde in Qt 6.8 eingeführt.

bool QThreadPool::waitForDone(int msecs)

Wartet bis zu msecs Millisekunden, bis alle Threads beendet sind, und entfernt alle Threads aus dem Thread-Pool. Gibt true zurück, wenn alle Threads entfernt wurden; andernfalls gibt sie false zurück. Wenn msecs gleich -1 ist, wartet diese Funktion auf das Beenden des letzten Threads.