QThreadPool Class

class HelloWorldTask : public QRunnable
{
    void run() override
    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    }
};

int main()
{
    //...
    HelloWorldTask *hello = new HelloWorldTask();
    // QThreadPool이 'hello'에 대한 소유권을 인수하고 자동으로 삭제합니다
    QThreadPool::globalInstance()->start(hello);
    //...
}

멤버 함수 문서

QThreadPool::QThreadPool(QObject *parent = nullptr)

지정된 ` parent`을 사용하여 스레드 풀을 생성합니다.

[virtual noexcept] QThreadPool::~QThreadPool()

QThreadPool 를 삭제합니다. 이 함수는 모든 실행 가능 객체가 완료될 때까지 대기합니다.

void QThreadPool::clear()

아직 시작되지 않은 실행 가능 객체를 대기열에서 제거합니다. runnable->autoDelete()가 true 를 반환하는 실행 가능 객체는 삭제됩니다.

start()도 참조하십시오 .

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

thread 가 이 스레드 풀에서 관리하는 스레드인 경우 true 를 반환합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

[static] QThreadPool *QThreadPool::globalInstance()

전역 ` QThreadPool ` 인스턴스를 반환합니다.

void QThreadPool::releaseThread()

reserveThread() 호출을 통해 이전에 예약된 스레드를 해제합니다.

reserveThread()도 참조하십시오 .

void QThreadPool::reserveThread()

activeThreadCount() 및 maxThreadCount()을 무시하고 스레드 하나를 예약합니다.

스레드 사용이 끝나면 releaseThread()를 호출하여 해당 스레드가 재사용될 수 있도록 하십시오.

releaseThread()도 참조하십시오 .

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

스레드의 현재 서비스 품질(QoS) 수준을 반환합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

setServiceLevel() 및 QThread::serviceLevel()도 참조하십시오 .

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

이 세터 호출 후 생성되는 스레드 객체의 서비스 품질(QoS) 수준을 ` serviceLevel`로 설정합니다.

모든 플랫폼에서 지원되는 것은 아닙니다. 자세한 내용은 QThread::setServiceLevel()을 참조하십시오.

이 함수는 Qt 6.9에서 도입되었습니다.

serviceLevel() 및 QThread::serviceLevel()도 참조하십시오 .

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

이 스레드를 할당하고, 이를 사용하여 runnable 를 실행합니다. 단, 이 스레드로 인해 현재 스레드 수가 maxThreadCount()를 초과하게 되는 경우는 예외입니다. 이 경우, runnable 는 대신 실행 대기열에 추가됩니다. priority 인수를 사용하여 실행 대기열의 실행 순서를 제어할 수 있습니다.

runnable->autoDelete()이 true 을 반환하면 스레드 풀이 runnable 에 대한 소유권을 갖게 되며, runnable->run()이 반환된 후 runnable 는 스레드 풀에 의해 자동으로 삭제됩니다. runnable->autoDelete()이 false 을 반환하면 runnable 에 대한 소유권은 호출자에게 남아 있습니다. 이 함수를 호출한 후 runnable 의 자동 삭제 설정을 변경하면 정의되지 않은 동작이 발생한다는 점에 유의하십시오.

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

이 스레드가 추가되면 현재 스레드 수가 ` maxThreadCount()`을 초과하게 되는 경우가 아니라면, 스레드를 예약하고 이를 사용하여 ` callableToRun`를 실행합니다. 해당 경우, ` callableToRun `가 대신 실행 대기열에 추가됩니다. ` priority ` 인자를 사용하여 실행 대기열의 실행 순서를 제어할 수 있습니다.

제약 사항

Callable 가 인수를 하나도 받지 않고 호출될 수 있는 함수이거나 함수 객체인 경우에만 오버로드 해결에 참여합니다.

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

reserveThread()를 통해 이전에 예약된 스레드를 해제하고, 이를 사용하여 runnable 를 실행합니다.

runnable->autoDelete()이 true 를 반환하면 스레드 풀이 runnable 의 소유권을 인수하며, runnable->run()이 반환된 후 runnable 는 스레드 풀에 의해 자동으로 삭제됩니다. runnable->autoDelete()이 false 를 반환하면 runnable 의 소유권은 호출자에게 남아 있습니다. 이 함수를 호출한 후 runnable 의 자동 삭제 설정을 변경하면 정의되지 않은 동작이 발생합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

reserveThread() 및 start()도 참조하십시오 .

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

reserveThread()를 통해 이전에 예약된 스레드를 해제하고, 이를 사용하여 callableToRun 을 실행합니다.

제약 조건

Callable 가 인수를 하나도 받지 않고 호출될 수 있는 함수이거나 함수 객체인 경우에만 오버로드 해결에 참여합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

bool QThreadPool::tryStart(QRunnable *runnable)

runnable 를 실행하기 위해 스레드를 예약하려고 시도합니다.

호출 시점에 사용 가능한 스레드가 없으면, 이 함수는 아무 작업도 수행하지 않고 false 를 반환합니다. 그렇지 않은 경우, 사용 가능한 스레드 하나를 사용하여 runnable 가 즉시 실행되고, 이 함수는 true 를 반환합니다.

성공 시, ` runnable->autoDelete()`가 ` true`를 반환하면 스레드 풀이 ` runnable `에 대한 소유권을 가져가며, ` runnable->run()`가 반환된 후 ` runnable `는 스레드 풀에 의해 자동으로 삭제됩니다. ` runnable->autoDelete()`가 ` false`를 반환하면 ` runnable `에 대한 소유권은 호출자에게 남아 있습니다. 이 함수를 호출한 후 ` runnable `의 자동 삭제 설정을 변경하면 정의되지 않은 동작이 발생한다는 점에 유의하십시오.

template <typename Callable> requires QRunnable::if_callable<Callable> bool QThreadPool::tryStart(Callable &&callableToRun)

callableToRun 을 실행하기 위해 스레드를 예약하려고 시도합니다.

호출 시점에 사용 가능한 스레드가 없으면, 이 함수는 아무 작업도 수행하지 않고 false 를 반환합니다. 그렇지 않은 경우, callableToRun 가 사용 가능한 스레드 하나를 사용하여 즉시 실행되며, 이 함수는 true 를 반환합니다.

제약 조건

Callable 가 인자 없이 호출될 수 있는 함수이거나 함수 객체인 경우에만 오버로드 해결에 참여합니다.

bool QThreadPool::tryTake(QRunnable *runnable)

지정된 runnable 가 아직 시작되지 않은 경우, 큐에서 이를 제거하려고 시도합니다. 실행 가능 객체가 시작되지 않은 경우, true 를 반환하며, runnable 의 소유권은 호출자에게 이전됩니다( runnable->autoDelete() == true 인 경우에도 마찬가지입니다). 그렇지 않은 경우 false 를 반환합니다.

start() 및 QRunnable::autoDelete()도 참조하십시오 .

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

deadline 의 유효 기간이 만료될 때까지 기다려 모든 스레드가 종료되도록 한 다음, 스레드 풀에서 모든 스레드를 제거합니다. 모든 스레드가 제거된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

bool QThreadPool::waitForDone(int msecs)

모든 스레드가 종료될 때까지 최대 msecs 밀리초 동안 대기한 후, 스레드 풀에서 모든 스레드를 제거합니다. 모든 스레드가 제거된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다. msecs 가 -1인 경우, 이 함수는 마지막 스레드가 종료될 때까지 대기합니다.