QThreadPool Class

class HelloWorldTask : public QRunnable
{ void run() override    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    } } ;int main() { //...HelloWorldTask *hello = new HelloWorldTask() ; // QThreadPool prend possession de 'hello' et le supprime automatiquement   QThreadPool::globalInstance()->start(hello) ; //... }

Documentation sur les fonctions membres

QThreadPool::QThreadPool(QObject *parent = nullptr)

Construit un pool de threads avec l'adresse parent.

[virtual noexcept] QThreadPool::~QThreadPool()

Détruit le site QThreadPool. Cette fonction se bloque jusqu'à ce que tous les exécutables soient terminés.

void QThreadPool::clear()

Supprime de la file d'attente les exécutables qui n'ont pas encore été lancés. Les exécutables pour lesquels runnable->autoDelete() renvoie true sont supprimés.

Voir aussi start().

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

Renvoie true si thread est un thread géré par ce pool de threads.

Cette fonction a été introduite dans Qt 6.0.

[static] QThreadPool *QThreadPool::globalInstance()

Renvoie l'instance globale de QThreadPool.

void QThreadPool::releaseThread()

Libère un thread précédemment réservé par un appel à reserveThread().

Voir aussi reserveThread().

void QThreadPool::reserveThread()

Réserve un fil de discussion, sans tenir compte de activeThreadCount() et maxThreadCount().

Une fois que vous avez terminé avec le thread, appelez releaseThread() pour permettre sa réutilisation.

Voir également releaseThread().

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

Renvoie le niveau de qualité de service actuel du thread.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi setServiceLevel() et QThread::serviceLevel().

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

Définit le niveau de qualité de service des objets threads créés après l'appel à ce setter à serviceLevel.

Le support n'est pas disponible sur toutes les plateformes. Consultez QThread::setServiceLevel() pour plus de détails.

Cette fonction a été introduite dans Qt 6.9.

Voir également serviceLevel() et QThread::serviceLevel().

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

Réserve un thread et l'utilise pour exécuter runnable, à moins que ce thread ne fasse dépasser le nombre de threads en cours à maxThreadCount(). Dans ce cas, runnable est ajouté à une file d'attente d'exécution. L'argument priority peut être utilisé pour contrôler l'ordre d'exécution de la file d'attente.

Notez que le pool de threads prend possession de runnable si runnable->autoDelete() renvoie true, et que runnable sera supprimé automatiquement par le pool de threads après le retour de runnable->run(). Si runnable->autoDelete() renvoie false, runnable reste la propriété de l'appelant. Notez que la modification de l'effacement automatique de runnable après l'appel de cette fonction entraîne un comportement indéfini.

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

Réserve un thread et l'utilise pour exécuter callableToRun, à moins que ce thread ne fasse dépasser le nombre de threads en cours à maxThreadCount(). Dans ce cas, callableToRun est ajouté à une file d'attente d'exécution. L'argument priority peut être utilisé pour contrôler l'ordre d'exécution de la file d'attente.

Contraintes

Participe à la résolution des surcharges uniquement si Callable est une fonction ou un objet fonction qui peut être appelé avec zéro argument.

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

Libère un thread précédemment réservé avec reserveThread() et l'utilise pour exécuter runnable.

Notez que le pool de threads prend possession de runnable si runnable->autoDelete() renvoie true, et que runnable sera supprimé automatiquement par le pool de threads après le retour de runnable->run(). Si runnable->autoDelete() renvoie false, runnable reste la propriété de l'appelant. Notez que la modification de l'effacement automatique de runnable après l'appel de cette fonction entraîne un comportement indéfini.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi reserveThread() et start().

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

Libère un thread précédemment réservé avec reserveThread() et l'utilise pour exécuter callableToRun.

Contraintes

Participe à la résolution des surcharges uniquement si Callable est une fonction ou un objet fonction qui peut être appelé avec zéro argument.

Cette fonction a été introduite dans Qt 6.3.

bool QThreadPool::tryStart(QRunnable *runnable)

Tente de réserver un thread pour l'exécution runnable.

Si aucun thread n'est disponible au moment de l'appel, cette fonction ne fait rien et renvoie false. Dans le cas contraire, runnable est exécuté immédiatement en utilisant un thread disponible et cette fonction renvoie true.

Notez qu'en cas de succès, le pool de threads prend possession de runnable si runnable->autoDelete() renvoie true, et que runnable sera automatiquement supprimé par le pool de threads après le retour de runnable->run(). Si runnable->autoDelete() renvoie false, la propriété de runnable reste à l'appelant. Notez que la modification de l'effacement automatique de runnable après l'appel de cette fonction entraîne un comportement indéfini.

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

Tente de réserver un thread pour l'exécution callableToRun.

Si aucun thread n'est disponible au moment de l'appel, cette fonction ne fait rien et renvoie false. Sinon, callableToRun est exécuté immédiatement en utilisant un thread disponible et cette fonction renvoie true.

Contraintes

Participe à la résolution des surcharges uniquement si Callable est une fonction ou un objet fonction qui peut être appelé avec zéro argument.

bool QThreadPool::tryTake(QRunnable *runnable)

Tente de retirer le runnable spécifié de la file d'attente s'il n'est pas encore démarré. Si l'exécutable n'a pas été démarré, renvoie true, et la propriété de runnable est transférée à l'appelant (même si runnable->autoDelete() == true). Sinon, elle renvoie false.

Voir aussi start() et QRunnable::autoDelete().

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

Attend l'expiration de deadline pour que tous les threads se retirent et supprime tous les threads du pool de threads. Retourne true si tous les threads ont été supprimés ; sinon, il retourne false.

Cette fonction a été introduite dans Qt 6.8.

bool QThreadPool::waitForDone(int msecs)

Attend jusqu'à msecs millisecondes que tous les threads soient sortis et supprime tous les threads du pool de threads. Elle renvoie true si tous les threads ont été supprimés, sinon elle renvoie false. Si msecs vaut -1, cette fonction attend que le dernier thread se termine.