QSemaphore Class

멤버 함수 문서

[explicit] QSemaphore::QSemaphore(int n = 0)

새로운 세마포어를 생성하고, 이 세마포어가 관리하는 리소스 수를 n 로 초기화합니다(기본값은 0입니다).

release() 및 available()도 참조하십시오 .

[noexcept] QSemaphore::~QSemaphore()

세마포어를 삭제합니다.

void QSemaphore::acquire(int n = 1)

세마포어로 보호되는 n 리소스를 확보하려고 시도합니다. n > available()인 경우, 이 호출은 충분한 리소스가 확보될 때까지 차단됩니다.

release(), available(), tryAcquire()도 참조하십시오 .

int QSemaphore::available() const

세마포어가 현재 사용할 수 있는 리소스의 수를 반환합니다. 이 수는 절대 음수가 될 수 없습니다.

acquire() 및 release()도 참조하십시오 .

void QSemaphore::release(int n = 1)

세마포어로 보호되고 있는 n 리소스를 해제합니다.

이 함수는 리소스를 "생성"하는 데에도 사용할 수 있습니다. 예를 들어:

QSemaphore sem(5);      // a semaphore that guards 5 resources
sem.acquire(5);         // acquire all 5 resources
sem.release(5);         // release the 5 resources
sem.release(10);        // "create" 10 new resources

QSemaphoreReleaser 는 이 함수를 감싼 RAII 래퍼입니다.

acquire(), available(), QSemaphoreReleaser도 참조하십시오 .

bool QSemaphore::tryAcquire(int n = 1)

세마포어가 보호하는 n 리소스를 확보하려고 시도하며, 성공 시 true 를 반환합니다. available() < n 인 경우, 이 호출은 리소스를 확보하지 않은 채 즉시 false 를 반환합니다.

예시:

QSemaphore sem(5);      // sem.available() == 5
sem.tryAcquire(250);    // sem.available() == 5, returns false
sem.tryAcquire(3);      // sem.available() == 2, returns true

acquire()도 참조하십시오 .

[since 6.6] bool QSemaphore::tryAcquire(int n, QDeadlineTimer timer)

세마포어로 보호되는 n 리소스를 확보하려고 시도하며, 성공 시 true 를 반환합니다. available() < n 인 경우, 이 호출은 timer 가 만료되어 리소스를 사용할 수 있게 될 때까지 대기합니다.

예시:

QSemaphore sem(5);                          // sem.available() == 5
sem.tryAcquire(250, QDeadlineTimer(1000));  // sem.available() == 5, waits 1000 milliseconds and returns false
sem.tryAcquire(3, QDeadlineTimer(30s));     // sem.available() == 2, returns true without waiting

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

acquire()도 참조하십시오 .

bool QSemaphore::tryAcquire(int n, int timeout)

세마포어로 보호되는 n 리소스를 확보하려고 시도하며, 성공 시 true 을 반환합니다. 만약 available() < n 인 경우, 이 호출은 리소스가 사용 가능해질 때까지 최대 timeout 밀리초 동안 대기합니다.

참고: ` timeout ` 매개변수로 음수를 전달하는 것은 ` acquire()`를 호출하는 것과 동일합니다. 즉, ` timeout `가 음수인 경우 이 함수는 리소스가 사용 가능해질 때까지 무한정 대기합니다.

예:

QSemaphore sem(5);            // sem.available() == 5
sem.tryAcquire(250, 1000);    // sem.available() == 5, waits 1000 milliseconds and returns false
sem.tryAcquire(3, 30000);     // sem.available() == 2, returns true without waiting

acquire()도 참조하십시오 .

[since 6.3] template <typename Rep, typename Period> bool QSemaphore::tryAcquire(int n, std::chrono::duration<Rep, Period> timeout)

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

[noexcept, since 6.3] bool QSemaphore::try_acquire()

이 함수는 std::counting_semaphore 과의 호환성을 위해 제공됩니다.

이는 tryAcquire(1) 를 호출하는 것과 동일하며, 리소스를 성공적으로 획득하면 이 함수는 true 을 반환합니다.

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

tryAcquire(), try_acquire_for(), try_acquire_until()도 참조하십시오 .

[since 6.3] template <typename Rep, typename Period> bool QSemaphore::try_acquire_for(const std::chrono::duration<Rep, Period> &timeout)

이 함수는 std::counting_semaphore 과의 호환성을 위해 제공됩니다.

이는 tryAcquire(1, timeout) 를 호출하는 것과 동일하며, 지정된 timeout 값에 따라 호출이 타임아웃됩니다. 이 함수는 리소스를 성공적으로 확보하면 true 를 반환합니다.

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

tryAcquire(), try_acquire(), try_acquire_until()도 참조하십시오 .

[since 6.3] template <typename Clock, typename Duration> bool QSemaphore::try_acquire_until(const std::chrono::time_point<Clock, Duration> &tp)

이 함수는 std::counting_semaphore 와의 호환성을 위해 제공됩니다.

이는 ` tryAcquire(1, tp - Clock::now())`를 호출하는 것과 동일하며, 대기 중 ` Clock `에 대한 조정을 무시하고 ` tp `(시간점)이 기록됨을 의미합니다. 이 함수는 리소스를 성공적으로 확보하면 ` true `를 반환합니다.

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

tryAcquire(), try_acquire(), try_acquire_for()도 참조하십시오 .