QtTaskTree::QBarrier Class
class QtTaskTree::QBarrier요청 시 완료되는 비동기 작업입니다. 더 보기...
| 헤더: | #include <qbarriertask.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS TaskTree) target_link_libraries(mytarget PRIVATE Qt6::TaskTree) |
| qmake: | QT += tasktree |
| 다음부터: | Qt 6.11 |
| 상속: | QObject |
| 상속받은 버전: | |
| 상태: | 기술 미리보기 |
이 클래스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 함수
| QBarrier(QObject *parent) | |
| void | advance() |
| qsizetype | current() const |
| bool | isRunning() const |
| qsizetype | limit() const |
| std::optional<QtTaskTree::DoneResult> | result() const |
| void | setLimit(qsizetype value) |
| void | start() |
| void | stopWithResult(QtTaskTree::DoneResult result) |
신호
| void | done(QtTaskTree::DoneResult result) |
재구현된 보호 함수
| virtual bool | event(QEvent *event) override |
상세 설명
QBarrier는 advance()에 대한 후속 호출이 배리어의 한계(기본값은 1)에 도달할 때까지 기다립니다. 이 함수는 DoneResult::Success 로 종료됩니다.
이 함수는 QTaskTree 레시피에서, 실행 중인 다른 작업이 후속 작업을 설정하는 데 필요한 데이터를 전달할 때까지 후속 순차 작업의 실행을 보류하는 데 자주 사용됩니다.
멤버 함수 문서
[explicit] QBarrier::QBarrier(QObject *parent)
주어진 ` parent`를 사용하여 `QBarrier`를 생성합니다.
void QBarrier::advance()
배리어를 전진시킵니다. advance() 호출 횟수가 배리어의 제한에 도달하면, 배리어는 ` DoneResult::Success` 상태로 종료됩니다.
qsizetype QBarrier::current() const
배리어의 현재 선행 횟수를 반환합니다.
[private signal] void QBarrier::done(QtTaskTree::DoneResult result)
이 신호는 배리어가 완료되어 실행의 마지막 result 을 통과했을 때 발신됩니다.
참고: 이 신호는 비공개 신호입니다. 신호 연결에서 사용할 수는 있지만, 사용자가 직접 발생시킬 수는 없습니다.
[override virtual protected] bool QBarrier::event(QEvent *event)
QObject::event(QEvent *e)를 재구현합니다.
bool QBarrier::isRunning() const
배리어가 현재 실행 중이면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
qsizetype QBarrier::limit() const
배리어의 현재 한도를 반환합니다.
setLimit()도 참조하십시오 .
std::optional<QtTaskTree::DoneResult> QBarrier::result() const
배리어 실행 결과를 반환합니다. 배리어가 시작되지 않았거나 아직 실행 중인 경우, 반환되는 옵셔널은 비어 있습니다. 그렇지 않은 경우, 마지막 실행 결과를 반환합니다.
void QBarrier::setLimit(qsizetype value)
한도를 value 로 설정합니다. 시작된 후, advance() 함수의 호출 횟수가 한도에 도달하면 배리어가 종료됩니다.
limit()도 참조하십시오 .
void QBarrier::start()
장벽을 가동합니다.
void QBarrier::stopWithResult(QtTaskTree::DoneResult result)
지정된 result 를 사용하여 실행 중인 배리어를 무조건 중지합니다. 배리어의 제한값은 무시됩니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
