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();

Dokumentation der Member-Funktionen

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

Erstellt eine `QThreadFunction` mit einem angegebenen ` parent`.

[override virtual] QThreadFunction::~QThreadFunction()

Löscht die „ QThreadFunction “. Wenn die „ QThreadFunction “ nicht ausgeführt wird, werden keine weiteren Aktionen durchgeführt; andernfalls wird die zugehörige Future abgebrochen, und je nach Einstellung der automatischen verzögerten Synchronisation werden die folgenden Aktionen durchgeführt:

Wenn die automatische verzögerte Synchronisation aktiviert ist, kann die Abbruchanforderung des Futures innerhalb der noch laufenden Funktion in einem separaten Thread abgefangen werden, sodass diese so schnell wie möglich beendet wird, ohne ihre Aufgabe vollständig auszuführen.

Schließlich sollte beim Beenden der Anwendung ` QThreadFunctionBase::syncAll()` aufgerufen werden, um alle Funktionen zu synchronisieren, die möglicherweise noch in separaten Threads laufen. Der Aufruf von ` QThreadFunctionBase::syncAll()` ist blockierend, falls einige Funktionen noch dabei sind, den Abbruchvorgang abzuschließen.

Siehe auch „ setAutoDelayedSync()“ und „ syncAll()“.

QFuture<ResultType> QThreadFunction::future() const

Gibt den „ QFuture “ <ResultType> zurück, der mit der in einem separaten Thread ausgeführten Funktion verknüpft ist.

QFutureWatcher<ResultType> *QThreadFunction::futureWatcher()

Gibt den Zeiger auf den „ QFutureWatcher<ResultType> “ zurück, der mit der in einem separaten Thread ausgeführten Funktion verknüpft ist. Die Lebensdauer des zurückgegebenen Watchers ist an die „ QThreadFunction “-Instanz gebunden.

Verwenden Sie diese Funktion, wenn Sie mehr Kontrolle über die zukünftige Ausführung benötigen, beispielsweise um eine Verbindung zu den Fortschrittssignalen des zurückgegebenen Watchers herzustellen.

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

Gibt den Zeiger „ const “ auf die „ QFutureWatcher<ResultType> “ zurück, die mit der in einem separaten Thread ausgeführten Funktion verknüpft ist.

bool QThreadFunction::isAutoDelayedSync() const

Gibt zurück, ob die automatische verzögerte Synchronisierung aktiviert ist.

Siehe auch syncAll() und setAutoDelayedSync().

bool QThreadFunction::isDone() const

Gibt zurück, ob die Ausführung der Funktion abgeschlossen ist.

bool QThreadFunction::isResultAvailable() const

Gibt zurück, ob das Ergebnis bereitsteht.

Siehe auch ` result()`.

ResultType QThreadFunction::result() const

Gibt den ResultType zurück, der von der in einem separaten Thread ausgeführten Funktion gemeldet wurde.

Siehe auch ` QFutureWatcher::result()`.

ResultType QThreadFunction::resultAt(int index) const

Gibt den ResultType zurück, der von der Funktion gemeldet wird, die in einem separaten Thread unter index ausgeführt wurde.

Siehe auch result() und QFutureWatcher::resultAt().

QList<ResultType> QThreadFunction::results() const

Gibt die Liste der ResultType zurück, die von der in einem separaten Thread ausgeführten Funktion gemeldet wurden.

Siehe auch result(), resultAt() und QFuture::results().

void QThreadFunction::setAutoDelayedSync(bool on)

Legt die automatische verzögerte Synchronisation auf „ on “ fest.

Standardmäßig ist die automatische verzögerte Synchronisation aktiviert, was bedeutet, dass die Freigabe des laufenden „ QThreadFunction “-Objekts nicht blockierend wartet, bis die in einem separaten Thread ausgeführte Funktion beendet ist. Stattdessen wird die zugehörige „ QFuture “ abgebrochen, und die Funktion läuft weiter, bis sie beendet ist. Die Abbruchmeldung kann von der in einem separaten Thread ausgeführten Funktion über das Argument „ QPromise “ abgefangen werden, sodass diese vorzeitig beendet werden kann, ohne ihre Aufgabe vollständig ausgeführt zu haben. Falls die automatische verzögerte Synchronisation aktiviert ist, muss beim Beenden der Anwendung „ QThreadFunctionBase::syncAll()“ aufgerufen werden, um alle möglicherweise in separaten Threads laufenden Funktionen zu synchronisieren.

Wenn die automatische verzögerte Synchronisation deaktiviert ist, erfolgt die Synchronisation bei der Zerstörung von ` QThreadFunction`, was den aufrufenden Thread für eine beträchtliche Zeit blockieren kann.

Die automatische Synchronisation wird nur verwendet, wenn ` QThreadFunction ` vom Hauptthread aus ausgeführt wurde.

Siehe auch ` syncAll()` und ` isAutoDelayedSync()`.

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

Legt fest, dass die Funktion „ function “ bei Aufruf von „start()“ mit dem übergebenen „ args “ in einem separaten Thread ausgeführt wird.

Siehe auch QtConcurrent::run().

void QThreadFunction::setThreadPool(QThreadPool *pool)

Legt die „ QThreadPool “ pool fest, die bei der Ausführung des Aufrufs verwendet werden soll. Wenn die übergebene „ pool “ den Wert „ nullptr “ hat, wird die „ QThreadPool::globalInstance()“ verwendet.

Siehe auch threadPool().

ResultType QThreadFunction::takeResult() const

Ruft den „ResultType“ ab, der von der in einem separaten Thread ausgeführten Funktion zurückgegeben wurde.

Siehe auch ` QFuture::takeResult()`.

QThreadPool *QThreadFunction::threadPool() const

Gibt den Thread-Pool zurück, der bei der Ausführung des Aufrufs verwendet wird. Wird „ nullptr “ zurückgegeben, wird „ QThreadPool::globalInstance()“ verwendet.

Siehe auch ` setThreadPool()`.