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

멤버 함수 문서

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

주어진 ` parent`를 사용하여 `QThreadFunction`을 생성합니다.

[override virtual] QThreadFunction::~QThreadFunction()

QThreadFunction 를 삭제합니다. QThreadFunction 가 실행 중이 아닌 경우 다른 작업은 수행되지 않으며, 실행 중인 경우 관련 퓨처가 취소되고, 자동 지연 동기화 설정에 따라 다음과 같은 작업이 수행됩니다:

자동 지연 동기화가 켜져 있을 때, 별도의 스레드에서 여전히 실행 중인 함수 내부에서 퓨처의 취소 요청이 가로채어질 수 있으므로, 해당 함수는 작업을 완료하지 않은 채 가능한 한 빨리 종료될 수 있습니다.

마지막으로, 애플리케이션 종료 시 별도의 스레드에서 여전히 실행 중일 가능성이 있는 모든 함수를 동기화하기 위해 QThreadFunctionBase::syncAll()을 호출해야 합니다. 일부 함수가 아직 종료 중일 경우, QThreadFunctionBase::syncAll() 호출은 차단됩니다.

setAutoDelayedSync() 및 syncAll()도 참조하십시오 .

QFuture<ResultType> QThreadFunction::future() const

별도의 스레드에서 실행된 함수와 관련된 <ResultType> 형식의 QFuture 을 반환합니다.

QFutureWatcher<ResultType> *QThreadFunction::futureWatcher()

별도의 스레드에서 실행된 함수와 연관된 ` QFutureWatcher<ResultType> `에 대한 포인터를 반환합니다. 반환된 워처의 수명은 ` QThreadFunction ` 인스턴스에 연동되어 있습니다.

예를 들어, 반환된 워처의 진행 신호에 연결하는 등 향후 실행을 더 세밀하게 제어해야 할 경우 이 함수를 사용하십시오.

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

별도의 스레드에서 실행된 함수와 연관된 QFutureWatcher<ResultType> 에 대한 const 포인터를 반환합니다.

bool QThreadFunction::isAutoDelayedSync() const

자동 지연 동기화가 활성화되어 있는지 여부를 반환합니다.

syncAll() 및 setAutoDelayedSync()도 참조하십시오 .

bool QThreadFunction::isDone() const

함수 실행이 완료되었는지 여부를 반환합니다.

bool QThreadFunction::isResultAvailable() const

결과가 준비되었는지 여부를 반환합니다.

result()도 참조하십시오 .

ResultType QThreadFunction::result() const

별도의 스레드에서 실행된 함수가 보고한 ResultType을 반환합니다.

QFutureWatcher::result()도 참조하십시오 .

ResultType QThreadFunction::resultAt(int index) const

index 에서 별도의 스레드에서 실행된 함수가 반환한 ResultType을 반환합니다.

result() 및 QFutureWatcher::resultAt()도 참조하십시오 .

QList<ResultType> QThreadFunction::results() const

별도의 스레드에서 실행된 함수가 보고한 ResultType 목록을 반환합니다.

result(), resultAt(), QFuture::results()도 참조하십시오 .

void QThreadFunction::setAutoDelayedSync(bool on)

자동 지연 동기화를 ` on`로 설정합니다.

기본적으로 자동 지연 동기화가 활성화되어 있으므로, 실행 중인 QThreadFunction 객체의 소멸은 별도의 스레드에서 실행 중인 함수가 완료될 때까지 차단 대기하지 않습니다. 대신, 연관된 QFuture 가 취소되고, 해당 함수는 완료될 때까지 계속 실행됩니다. 별도의 스레드에서 실행 중인 함수는 ` QPromise ` 인수를 통해 이 중지를 가로챌 수 있으므로, 작업을 완료하지 않은 채 조기에 종료될 수 있습니다. 자동 지연 동기화가 활성화된 경우, 별도의 스레드에서 실행 중일 수 있는 모든 함수를 동기화하기 위해 애플리케이션 종료 시 ` QThreadFunctionBase::syncAll()`를 호출해야 합니다.

자동 지연 동기화가 꺼져 있는 경우, 동기화는 QThreadFunction 가 소멸될 때 발생하며, 이로 인해 호출자 스레드가 상당한 시간 동안 차단될 수 있습니다.

자동 동기화는 QThreadFunction 가 메인 스레드에서 실행된 경우에만 사용됩니다.

syncAll() 및 isAutoDelayedSync()도 참조하십시오 .

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

start()가 호출될 때, 전달된 ` args `를 사용하여 ` function `를 별도의 스레드에서 실행하도록 설정합니다.

QtConcurrent::run()도 참조하십시오 .

void QThreadFunction::setThreadPool(QThreadPool *pool)

호출을 실행할 때 사용할 ` QThreadPool ` pool 을 설정합니다. 전달된 ` pool `이 ` nullptr`인 경우, ` QThreadPool::globalInstance()`이 사용됩니다.

threadPool()도 참조하십시오 .

ResultType QThreadFunction::takeResult() const

별도의 스레드에서 실행된 함수가 반환한 ResultType을 가져옵니다.

QFuture::takeResult()도 참조하십시오 .

QThreadPool *QThreadFunction::threadPool() const

호출을 실행할 때 사용되는 스레드 풀을 반환합니다. nullptr 가 반환되면 QThreadPool::globalInstance()이 사용됩니다.

setThreadPool()도 참조하십시오 .