En esta página

Contador principal

Muestra cómo supervisar el progreso de operaciones simultáneas.

El siguiente ejemplo muestra cómo crear una aplicación QtWidgets interactiva y sin bloqueo utilizando la clase ` QFutureWatcher ` y las funciones `filteredReduced ` de Qt Concurrent. Con este ejemplo, el usuario puede crear una lista de números enteros ( QList ) cuyo tamaño se puede modificar. La lista se rellenará automáticamente con números naturales que van desde el 1 hasta el n. A continuación, el programa buscará números primos dentro de la lista y mostrará el recuento total de números primos encontrados.

Contador de números primos con selector de opción de reducción, botón de inicio, barras de progreso y resultado del recuento de números primos

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Configuración de las conexiones

La Qt Concurrent biblioteca proporciona las funciones `filteredReduced`, que pueden funcionar en dos modos: OrderedReduce and UnorderedReduce. En el modo OrderedReduce, la función reductora se invoca siguiendo el orden de la secuencia original, mientras que en el modo UnorderedReduce se accede a los elementos de forma aleatoria.

Tras configurar la interfaz de usuario con los elementos deseados, es necesario conectarlos a las señales de las operaciones concurrentes mediante el mecanismo de señales y ranuras de Qt. En este ejemplo, utilizamos la clase ` QFutureWatcher ` para supervisar el progreso de las operaciones concurrentes y proporcionar las señales necesarias para implementar la interfaz gráfica de usuario interactiva.

    ...
connect(ui->pushButton, &QPushButton::clicked,
        this, [this] { start(); });
connect(&watcher, &QFutureWatcher<Element>::finished,
        this, [this] { finish(); });
connect(&watcher, &QFutureWatcher<Element>::progressRangeChanged,
        ui->progressBar, &QProgressBar::setRange);
connect(&watcher, &QFutureWatcher<Element>::progressValueChanged,
        ui->progressBar, &QProgressBar::setValue);
    ...

La clase ` QFutureWatcher ` desempeña un papel fundamental en este ejemplo, ya que proporciona las señales necesarias para actualizar la interfaz de usuario en respuesta a los cambios en las operaciones concurrentes.

Inicio de la operación concurrente

Tras conectar todas las señales y ranuras, y cuando el usuario pulsa el botón QPushButton, se invoca la función ` start() `.

En la función ` start() `, llamamos a la función `filteredReduced` de ` Qt Concurrent ` y establecemos el `future` en el miembro ` QFutureWatcher `. Para garantizar que esta operación se ejecute de forma verdaderamente concurrente, especificamos un ` QThreadPool ` independiente como primer parámetro. Este enfoque también evita cualquier posible bloqueo en el grupo de subprocesos global. Pasamos el ` QList ` de enteros como contenedor, unas funciones `filter` y `reduce` estáticas y, por último, el indicador ` ReduceOption `.

    ...
void PrimeCounter::start()
{
    if (ui->pushButton->isChecked()) {
        ui->comboBox->setEnabled(false);
        ui->pushButton->setText(tr("Cancel"));
        ui->labelResult->setText(tr("Calculating ..."));
        ui->labelFilter->setText(tr("Selected Reduce Option: %1").arg(ui->comboBox->currentText()));
        fillElementList(ui->horizontalSlider->value() * stepSize);

        timer.start();
        watcher.setFuture(
            QtConcurrent::filteredReduced(
                &pool,
                elementList,
                filterFunction,
                reduceFunction,
                currentReduceOpt | QtConcurrent::SequentialReduce));
    ...

Analicemos las funciones filter y reduce. En este ejemplo, estas funciones se declaran como estáticas, ya que no dependen de ninguna variable miembro. Sin embargo, podrían especificarse fácilmente como lambdas o funciones miembro.

La función «filter» marca elementos para su posterior reducción mediante la función «reduce». Esta implementación es un sencillo filtro de números primos. Como esta función toma una referencia const como argumento, permite un funcionamiento seguro entre subprocesos en el contenedor sobre el que opera.

    ...
bool PrimeCounter::filterFunction(const Element &element)
{
    // Filter for primes
    if (element <= 1)
        return false;
    for (Element i = 2; i*i <= element; ++i) {
        if (element % i == 0)
            return false;
    }
    return true;
}
    ...

La función `reduce` toma como primer parámetro una referencia modificable del mismo tipo que el contenedor sobre el que opera. El segundo parámetro es el elemento previamente filtrado por la función `filter`. En este ejemplo, contamos el número de números primos.

    ...
void PrimeCounter::reduceFunction(Element &out, const Element &value)
{
    // Count the amount of primes.
    Q_UNUSED(value);
    ++out;
}
    ...

Proyecto de ejemplo en @code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.