QThreadPool Class

class HelloWorldTask : public QRunnable
{
    void run() override
    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    }
};

int main()
{
    //...
    HelloWorldTask *hello = new HelloWorldTask();
    // QThreadPool übernimmt die Verantwortung und löscht „hello“ automatisch
    QThreadPool::globalInstance()->start(hello);
    //...
}

Dokumentation zu den Mitgliedsfunktionen

QThreadPool::QThreadPool(QObject *parent = nullptr)

Erstellt einen Thread-Pool mit dem angegebenen ` parent`.

[virtual noexcept] QThreadPool::~QThreadPool()

Löst die „ QThreadPool “ auf. Diese Funktion bleibt blockiert, bis alle „Runnables“ abgeschlossen sind.

void QThreadPool::clear()

Entfernt die noch nicht gestarteten „Runnables“ aus der Warteschlange. Die „Runnables“, für die runnable->autoDelete() den Wert „ 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 Thread-Pool verwaltet wird.

Diese Funktion wurde in Qt 6.0 eingeführt.

[static] QThreadPool *QThreadPool::globalInstance()

Gibt die globale Instanz von „ 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, wobei „ activeThreadCount()“ und „ maxThreadCount()“ ignoriert werden.

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

Siehe auch ` releaseThread()`.

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

Gibt die aktuelle Quality-of-Service-Stufe des Threads zurück.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ setServiceLevel()“ und „ QThread::serviceLevel()“.

[since 6.9] void QThreadPool::setServiceLevel(QThread::QualityOfService serviceLevel)

Setzt die Quality-of-Service-Stufe von Thread-Objekten, die nach dem Aufruf dieses Setters erstellt werden, auf „ serviceLevel “.

Die Unterstützung ist nicht auf jeder Plattform verfügbar. Weitere Informationen finden Sie unter QThread::setServiceLevel().

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ serviceLevel()“ und „ QThread::serviceLevel()“.

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

Reserviert einen Thread und verwendet diesen zur Ausführung von ` runnable`, es sei denn, durch diesen Thread würde die aktuelle Thread-Anzahl den Wert von ` maxThreadCount()` überschreiten. In diesem Fall wird ` runnable ` stattdessen in eine Ausführungswarteschlange gestellt. Mit dem Argument ` priority ` lässt sich die Ausführungsreihenfolge in der Warteschlange steuern.

Beachten Sie, dass der Thread-Pool die Eigentumsrechte an „ runnable “ übernimmt, wenn „ runnable->autoDelete()“ „ true “ zurückgibt, und dass „ runnable “ nach der Rückkehr von „ runnable->run()“ automatisch vom Thread-Pool gelöscht wird. Wenn „ runnable->autoDelete()“ „ false “ zurückgibt, verbleiben die Eigentumsrechte an „ runnable “ beim Aufrufer. Beachten Sie, dass eine Änderung der automatischen Löschung unter „ runnable “ nach dem Aufruf dieser Funktionen zu undefiniertem Verhalten führt.

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

Reserviert einen Thread und verwendet ihn zur Ausführung von ` callableToRun`, es sei denn, durch diesen Thread würde die aktuelle Thread-Anzahl den Wert von ` maxThreadCount()` überschreiten. In diesem Fall wird ` callableToRun ` stattdessen einer Ausführungswarteschlange hinzugefügt. Mit dem Argument ` priority ` lässt sich die Ausführungsreihenfolge in der Ausführungswarteschlange steuern.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn ` Callable ` eine Funktion oder ein Funktionsobjekt ist, das mit null Argumenten aufgerufen werden kann.

[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 die Eigentumsrechte an ` runnable ` übernimmt, wenn ` runnable->autoDelete()` den Wert ` true` zurückgibt, und dass ` runnable ` nach der Rückkehr von ` runnable->run()` automatisch vom Thread-Pool gelöscht wird. Wenn ` runnable->autoDelete()` den Wert ` false` zurückgibt, verbleibt das Eigentumsrecht an ` runnable ` beim Aufrufer. Beachten Sie, dass eine Änderung der automatischen Löschung unter ` runnable ` nach dem Aufruf dieser Funktionen 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> requires QRunnable::if_callable<Callable> void QThreadPool::startOnReservedThread(Callable &&callableToRun)

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

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn ` Callable ` eine Funktion oder ein Funktionsobjekt ist, das ohne Argumente aufgerufen werden kann.

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.

Sind zum Zeitpunkt des Aufrufs keine Threads verfügbar, führt diese Funktion keine Aktion aus 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 die Verantwortung für ` runnable ` übernimmt, wenn ` runnable->autoDelete()` ` true` zurückgibt, und dass ` runnable ` vom Thread-Pool automatisch gelöscht wird, nachdem ` runnable->run()` zurückgekehrt ist. Wenn ` runnable->autoDelete()` ` false` zurückgibt, verbleibt die Verantwortung für ` runnable ` beim Aufrufer. Beachten Sie, dass eine Änderung der automatischen Löschung unter ` runnable ` nach dem Aufruf dieser Funktion zu undefiniertem Verhalten führt.

template <typename Callable> requires QRunnable::if_callable<Callable> bool QThreadPool::tryStart(Callable &&callableToRun)

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

Sind zum Zeitpunkt des Aufrufs keine Threads verfügbar, führt diese Funktion keine Aktion aus und gibt „ false “ zurück. Andernfalls wird „ callableToRun “ sofort unter Verwendung eines verfügbaren Threads ausgeführt, und diese Funktion gibt „ true “ zurück.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ Callable “ eine Funktion oder ein Funktionsobjekt ist, das ohne Argumente aufgerufen werden kann.

bool QThreadPool::tryTake(QRunnable *runnable)

Versucht, das angegebene „ runnable “ aus der Warteschlange zu entfernen, sofern es noch nicht gestartet wurde. Wenn das „runnable“ noch nicht gestartet wurde, wird „ true “ zurückgegeben, und die Eigentumsrechte an „ runnable “ werden auf den Aufrufer übertragen (auch wenn „ runnable->autoDelete() == true “ gilt). Andernfalls wird „ false “ zurückgegeben.

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

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

Wartet, bis „ deadline “ abgelaufen ist, damit alle Threads beendet werden, 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 wird „ false “ zurückgegeben. Wenn „ msecs “ den Wert -1 hat, wartet diese Funktion, bis der letzte Thread beendet ist.