QThreadPool Class

HelloWorldTask 클래스: public QRunnable
{ void run() override    {
        qDebug() << "Hello world from thread" << QThread::currentThread();
    } }; 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()도 참조하세요 .

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

스레드를 예약하고 이 스레드로 인해 현재 스레드 수가 maxThreadCount()을 초과하지 않는 한 runnable 을 실행하는 데 사용합니다. 이 경우 runnable 가 대신 실행 대기열에 추가됩니다. priority 인수를 사용하여 실행 대기열의 실행 순서를 제어할 수 있습니다.

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

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

이 함수는 오버로드된 함수입니다.

스레드를 예약하고 이 스레드로 인해 현재 스레드 수가 maxThreadCount()을 초과하지 않는 한 callableToRun 을 실행하는 데 사용합니다. 이 경우 callableToRun 가 대신 실행 대기열에 추가됩니다. priority 인수를 사용하여 실행 대기열의 실행 순서를 제어할 수 있습니다.

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

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

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

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

reserveThread() 및 start()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

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

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

bool QThreadPool::tryStart(QRunnable *runnable)

runnable 을 실행할 스레드 예약을 시도합니다.

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

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

template <typename Callable, QRunnable::if_callable<Callable> = true> bool QThreadPool::tryStart(Callable &&callableToRun)

이 함수는 과부하된 함수입니다.

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

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

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이면 이 함수는 마지막 스레드가 종료될 때까지 기다립니다.