QThreadPool Class

clase TareaHolaMundo : public QRunnable
{ void run() override    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    } };int main() { //...HelloWorldTask *hola = new HelloWorldTask(); // QThreadPool toma posesión y borra 'hola' automáticamente   QThreadPool::globalInstance()->start(hola); //...}

Documentación de funciones miembro

QThreadPool::QThreadPool(QObject *parent = nullptr)

Crea un grupo de hilos con la dirección parent.

[virtual noexcept] QThreadPool::~QThreadPool()

Destruye el QThreadPool. Esta función se bloqueará hasta que se hayan completado todos los ejecutables.

void QThreadPool::clear()

Elimina de la cola las ejecutables que aún no se han iniciado. Se eliminan las ejecutables para las que runnable->autoDelete() devuelve true.

Véase también start().

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

Devuelve true si thread es un hilo gestionado por este grupo de hilos.

Esta función se introdujo en Qt 6.0.

[static] QThreadPool *QThreadPool::globalInstance()

Devuelve la instancia global de QThreadPool.

void QThreadPool::releaseThread()

Libera un hilo previamente reservado por una llamada a reserveThread().

Véase también reserveThread().

void QThreadPool::reserveThread()

Reserva un hilo, sin tener en cuenta activeThreadCount() y maxThreadCount().

Una vez que hayas terminado con el hilo, llama a releaseThread() para permitir su reutilización.

Véase también releaseThread().

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

Devuelve el nivel actual de Calidad de Servicio del hilo.

Esta función se introdujo en Qt 6.9.

Véase también setServiceLevel() y QThread::serviceLevel().

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

Establece el nivel de Calidad de Servicio de los objetos hilo creados después de la llamada a este setter en serviceLevel.

El soporte no está disponible en todas las plataformas. Consulte QThread::setServiceLevel() para más detalles.

Esta función se introdujo en Qt 6.9.

Véase también serviceLevel() y QThread::serviceLevel().

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

Reserva un subproceso y lo utiliza para ejecutar runnable, a menos que este subproceso haga que el número actual de subprocesos supere maxThreadCount(). En ese caso, runnable se añade a una cola de ejecución. El argumento priority puede utilizarse para controlar el orden de ejecución de la cola de ejecución.

Tenga en cuenta que el grupo de hilos toma posesión de runnable si runnable->autoDelete() devuelve true, y runnable será eliminado automáticamente por el grupo de hilos después de que runnable->run() devuelva. Si runnable->autoDelete() devuelve false, la propiedad de runnable permanece con el que llama. Tenga en cuenta que cambiar el auto-borrado en runnable después de llamar a esta función resulta en un comportamiento indefinido.

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

Reserva un subproceso y lo utiliza para ejecutar callableToRun, a menos que este subproceso haga que el número actual de subprocesos supere maxThreadCount(). En ese caso, callableToRun se añade a una cola de ejecución. El argumento priority puede utilizarse para controlar el orden de ejecución de la cola de ejecución.

Restricciones

Participa en la resolución de sobrecargas sólo si Callable es una función u objeto de función que puede llamarse con cero argumentos.

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

Libera un hilo previamente reservado con reserveThread() y lo utiliza para ejecutar runnable.

Tenga en cuenta que el repositorio de hilos toma la propiedad de runnable si runnable->autoDelete() devuelve true, y runnable será eliminado automáticamente por el repositorio de hilos tras la devolución de runnable->run(). Si runnable->autoDelete() devuelve false, la propiedad de runnable permanece con el que llama. Tenga en cuenta que cambiar el auto-borrado en runnable después de llamar a esta función resulta en un comportamiento indefinido.

Esta función se introdujo en Qt 6.3.

Véase también reserveThread() y start().

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

Libera un hilo previamente reservado con reserveThread() y lo utiliza para ejecutar callableToRun.

Restricciones

Participa en la resolución de sobrecargas sólo si Callable es una función u objeto de función que puede ser llamado con cero argumentos.

Esta función se introdujo en Qt 6.3.

bool QThreadPool::tryStart(QRunnable *runnable)

Intenta reservar un subproceso para ejecutar runnable.

Si no hay subprocesos disponibles en el momento de la llamada, esta función no hace nada y devuelve false. En caso contrario, runnable se ejecuta inmediatamente utilizando un subproceso disponible y esta función devuelve true.

Tenga en cuenta que, en caso de éxito, el grupo de hilos toma posesión de runnable si runnable->autoDelete() devuelve true, y runnable será eliminado automáticamente por el grupo de hilos tras la devolución de runnable->run(). Si runnable->autoDelete() devuelve false, la propiedad de runnable permanece con el que llama. Tenga en cuenta que cambiar el auto-borrado en runnable después de llamar a esta función resulta en un comportamiento indefinido.

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

Intenta reservar un subproceso para ejecutar callableToRun.

Si no hay subprocesos disponibles en el momento de la llamada, esta función no hace nada y devuelve false. En caso contrario, callableToRun se ejecuta inmediatamente utilizando un subproceso disponible y esta función devuelve true.

Restricciones

Participa en la resolución de sobrecargas sólo si Callable es una función u objeto de función que puede ser llamado con cero argumentos.

bool QThreadPool::tryTake(QRunnable *runnable)

Intenta eliminar el runnable especificado de la cola si aún no se ha iniciado. Si la ejecutable no se ha iniciado, devuelve true, y la propiedad de runnable se transfiere a la persona que llama (incluso cuando runnable->autoDelete() == true). En caso contrario, devuelve false.

Véase también start() y QRunnable::autoDelete().

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

Espera hasta que deadline expira para que todos los hilos salgan y elimina todos los hilos del pool de hilos. Devuelve true si se han eliminado todos los subprocesos; en caso contrario, devuelve false.

Esta función se introdujo en Qt 6.8.

bool QThreadPool::waitForDone(int msecs)

Espera hasta msecs milisegundos para que todos los hilos salgan y elimina todos los hilos del pool de hilos. Devuelve true si se han eliminado todos los subprocesos; en caso contrario, devuelve false. Si msecs es -1, esta función espera a que salga el último subproceso.