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 호환성을 위해 제공됩니다.

주어진 timeout 값에서 호출 시간이 초과되는 tryAcquire(1, 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()도 참조하십시오 .