QtTaskTree::QThreadFunction Class

static void copyFile(QPromise<void> &promise, const QString &source,
                     const QString &destination)
{
    const QFileInfo fi(source);
    if (!fi.exists()) {
        promise.future().cancel(); // The QThreadFunction finishes with DoneResult::Error
        return;
    }

    // Copy file...
}

QThreadFunction<void> task;
task.setThreadFunctionData(copyFile, "source.txt", "dest.txt");
task.start();

Documentación de las funciones miembro

[default] QThreadFunction::QThreadFunction(QObject *parent = nullptr)

Construye un QThreadFunction con un parent dado .

[override virtual] QThreadFunction::~QThreadFunction()

Destruye el QThreadFunction. Si el QThreadFunction no está en marcha, no se realiza ninguna otra acción, en caso contrario se cancela el futuro asociado, y dependiendo de la sincronización automática retardada se realizan las siguientes acciones:

Cuando la sincronización automática retardada está activada, la cancelación del futuro puede ser interceptada dentro de la función aún en ejecución en un hilo separado, para que pueda terminar lo antes posible sin completar su trabajo.

Finalmente, al salir de la aplicación, se debe llamar a QThreadFunctionBase::syncAll() para sincronizar todas las funciones que aún se estén ejecutando potencialmente en hilos separados. La llamada a QThreadFunctionBase::syncAll() es bloqueante en caso de que algunas funciones aún estén finalizando.

Véase también setAutoDelayedSync() y syncAll().

QFuture<ResultType> QThreadFunction::future() const

Devuelve el QFuture<ResultType> asociado a la función ejecutada en un hilo independiente.

QFutureWatcher<ResultType> *QThreadFunction::futureWatcher()

Devuelve el puntero al QFutureWatcher<ResultType> asociado con la función ejecutada en un hilo separado. El tiempo de vida del observador devuelto está ligado a la instancia QThreadFunction.

Utilice esta función si necesita más control sobre la ejecución futura, por ejemplo, para conectarse a las señales de progreso del observador devuelto.

const QFutureWatcher<ResultType> *QThreadFunction::futureWatcher() const

Devuelve el puntero const al QFutureWatcher<ResultType> asociado a la función ejecutada en un hilo independiente.

bool QThreadFunction::isAutoDelayedSync() const

Devuelve si la sincronización automática retardada está activada.

Véase también syncAll() y setAutoDelayedSync().

bool QThreadFunction::isDone() const

Devuelve si la ejecución de la función ha finalizado.

bool QThreadFunction::isResultAvailable() const

Devuelve si el resultado está listo.

Véase también result().

ResultType QThreadFunction::result() const

Devuelve el ResultType reportado por la función ejecutada en un hilo separado.

Véase también QFutureWatcher::result().

ResultType QThreadFunction::resultAt(int index) const

Devuelve el ResultType reportado por la función ejecutada en un hilo separado en index.

Véase también result() y QFutureWatcher::resultAt().

QList<ResultType> QThreadFunction::results() const

Devuelve la lista de ResultType reportados por la función ejecutada en un hilo separado.

Véase también result(), resultAt() y QFuture::results().

void QThreadFunction::setAutoDelayedSync(bool on)

Establece la sincronización automática retardada en on.

Por defecto, una sincronización automática retardada está activada, lo que significa que la destrucción del objeto QThreadFunction en ejecución no esperará en bloqueo hasta que la función que se ejecuta en un hilo separado finalice. En su lugar, se cancela el QFuture asociado, y la función se deja en ejecución hasta que finalice. La cancelación puede ser interceptada por la función que se ejecuta en un hilo separado a través del argumento QPromise, de modo que puede terminar antes de tiempo sin completar su trabajo. En caso de que la sincronización automática retardada esté activada, es necesario llamar a QThreadFunctionBase::syncAll() al salir de la aplicación, para sincronizar todas las funciones que posiblemente se estén ejecutando en hilos separados.

Cuando la sincronización automática retardada está desactivada, la sincronización se produce en el momento de la destrucción de QThreadFunction, lo que puede bloquear el subproceso que realiza la llamada durante un tiempo considerable.

La sincronización automática sólo se utiliza cuando QThreadFunction se ejecuta desde el hilo principal.

Véase también syncAll() y isAutoDelayedSync().

template <typename Function, typename... Args> void QThreadFunction::setThreadFunctionData(Function &&function, Args &&... args)

Establece el function que se ejecutará con args pasado en un hilo separado cuando se llame a start().

Véase también QtConcurrent::run().

void QThreadFunction::setThreadPool(QThreadPool *pool)

Establece el QThreadPool pool que se utilizará al ejecutar la llamada. Si el pool pasado es nullptr, se utiliza QThreadPool::globalInstance().

Véase también threadPool().

ResultType QThreadFunction::takeResult() const

Toma (mueve) el ResultType reportado por la función ejecutada en un hilo separado.

Véase también QFuture::takeResult().

QThreadPool *QThreadFunction::threadPool() const

Devuelve el grupo de hilos que se utiliza al ejecutar la llamada. Si se devuelve nullptr, se utiliza QThreadPool::globalInstance().

Véase también setThreadPool().