QSystemSemaphore Class

멤버 함수 문서

QSystemSemaphore::QSystemSemaphore(const QNativeIpcKey &key, int initialValue = 0, QSystemSemaphore::AccessMode mode = Open)

지정된 key 에 대한 시스템 세마포어를 요청합니다. initialValue 및 mode 매개변수는 다음 규칙에 따라 사용되며, 이는 시스템에 따라 다릅니다.

Unix에서 mode 가 Open 이고 시스템에 key 로 식별되는 세마포어가 이미 있는 경우 해당 세마포어가 사용되며 세마포어의 리소스 수는 변경되지 않습니다(즉, initialValue 은 무시됩니다). 그러나 시스템에 key 으로 식별되는 세마포어가 아직 없는 경우 해당 키에 대한 새 세마포어를 생성하고 리소스 카운트를 initialValue 으로 설정합니다.

Unix에서 mode 이 Create 이고 시스템에 key 로 식별되는 세마포어가 이미 있는 경우 해당 세마포어가 사용되고 리소스 카운트는 initialValue 로 설정됩니다. 시스템에 key 로 식별되는 세마포어가 아직 없는 경우 해당 키에 대한 새 세마포어를 생성하고 리소스 카운트는 initialValue 로 설정됩니다.

Windows에서 mode 은 무시되고 시스템은 항상 지정된 key 에 대한 세마포어를 생성하려고 시도합니다. 시스템에 key 로 식별된 세마포어가 아직 없는 경우 세마포어를 생성하고 리소스 카운트를 initialValue 로 설정합니다. 그러나 시스템에 key 로 식별된 세마포어가 이미 있는 경우 해당 세마포어를 사용하고 initialValue 은 무시합니다.

mode 매개변수는 프로세스 충돌 후에도 세마포어가 살아남는 경우를 처리하기 위해 유닉스 시스템에서만 사용됩니다. 이 경우 동일한 key 으로 세마포어를 할당하는 다음 프로세스는 충돌에서 살아남은 세마포어를 사용하게 되며, mode 이 Create 이 아닌 경우 리소스 카운트는 initialValue 으로 재설정되지 않고 충돌한 프로세스에서 부여한 초기 값을 유지합니다.

acquire() 및 key()도 참조하세요 .

QSystemSemaphore::QSystemSemaphore(const QString &key, int initialValue = 0, QSystemSemaphore::AccessMode mode = Open)

레거시 키 key 로 식별되는 시스템 세마포어를 요청합니다.

[noexcept] QSystemSemaphore::~QSystemSemaphore()

소멸자는 QSystemSemaphore 객체를 소멸하지만, QSystemSemaphore 인스턴스가 해당 시스템 세마포어에 존재하는 마지막 인스턴스가 아닌 한 기본 시스템 세마포어는 시스템에서 제거되지 않습니다.

소멸자의 두 가지 중요한 부작용은 시스템에 따라 다릅니다. Windows에서 이 세마포어에 대해 acquire()가 호출되었지만 release()가 호출되지 않은 경우, release()는 소멸자에 의해 호출되지 않으며 프로세스가 정상적으로 종료될 때 리소스가 해제되지 않습니다. 이는 프로그램 버그로서 동일한 리소스를 획득하려는 다른 프로세스에서 교착 상태를 일으킬 수 있는 원인이 될 수 있습니다. 유닉스에서는 소멸자가 호출되기 전에 해제되지 않은 획득한 리소스는 프로세스가 종료될 때 자동으로 해제됩니다.

bool QSystemSemaphore::acquire()

이 세마포어가 보호하는 자원 중 하나라도 있으면 획득하고 true 을 반환합니다. 이 세마포어가 보호하는 모든 자원이 이미 획득된 경우, 동일한 키를 가진 세마포어를 가진 다른 프로세스나 스레드가 자원 중 하나를 해제할 때까지 호출이 차단됩니다.

false가 반환되면 시스템 오류가 발생한 것입니다. error ()를 호출하여 발생한 오류를 나타내는 QSystemSemaphore::SystemSemaphoreError 값을 가져옵니다.

release()도 참조하세요 .

QSystemSemaphore::SystemSemaphoreError QSystemSemaphore::error() const

오류가 발생했는지 여부와 발생한 경우 어떤 오류인지를 나타내는 값을 반환합니다.

errorString()도 참조하세요 .

QString QSystemSemaphore::errorString() const

마지막으로 발생한 오류에 대한 텍스트 설명을 반환합니다. error ()가 error value 을 반환하는 경우 이 함수를 호출하여 오류를 설명하는 텍스트 문자열을 가져옵니다.

error()도 참조하세요 .

QString QSystemSemaphore::key() const

이 시스템 세마포어에 할당된 레거시 키를 반환합니다. 이 키는 다른 프로세스에서 세마포어에 액세스할 수 있는 이름입니다.

setKey()도 참조하세요 .

QNativeIpcKey QSystemSemaphore::nativeIpcKey() const

이 시스템 세마포어에 할당된 키를 반환합니다. 이 키는 다른 프로세스에서 세마포어에 액세스할 수 있는 이름입니다.

네이티브 키를 사용하여 Qt에서 생성하지 않은 시스템 세마포어에 액세스하거나 Qt가 아닌 응용 프로그램에 액세스 권한을 부여할 수 있습니다. 자세한 내용은 네이티브 IPC 키를 참조하십시오.

setNativeKey()도 참조하십시오 .

bool QSystemSemaphore::release(int n = 1)

세마포어가 보호하는 n 리소스를 해제합니다. 시스템 오류가 없는 한 true 을 반환합니다.

예제: 5개의 리소스가 있는 시스템 세마포어를 생성하고 모두 획득한 다음 모두 해제합니다.

QSystemSemaphore sem(QSystemSemaphore::platformSafeKey("market"), 5, QSystemSemaphore::Create);
for (int i = 0; i < 5; ++i)  // acquire all 5 resources
    sem.acquire();
sem.release(5);              // release the 5 resources

이 함수는 리소스를 '생성'할 수도 있습니다. 예를 들어, 위의 일련의 문 바로 다음에 다음과 같은 문을 추가한다고 가정해 보겠습니다:

sem.release(10);          // "create" 10 new resources

이제 세마포어가 이미 존재하던 5개의 자원에 더해 10개의 새로운 자원을 보호하고 있습니다. 일반적으로 이 함수를 사용하여 더 많은 리소스를 생성하지는 않습니다.

acquire()도 참조하세요 .

void QSystemSemaphore::setKey(const QString &key, int initialValue = 0, QSystemSemaphore::AccessMode mode = Open)

이 함수는 생성자와 동일하게 작동합니다. 이 QSystemSemaphore 객체를 재구성합니다. 새 key 이 이전 키와 다른 경우 이 함수를 호출하는 것은 이전 키로 세마포어의 소멸자를 호출한 다음 생성자를 호출하여 새 key 로 새 세마포어를 생성하는 것과 같습니다. initialValue 및 mode 매개변수는 생성자에 대해 정의된 대로입니다.

QSystemSemaphore() 및 key()도 참조하세요 .

void QSystemSemaphore::setNativeKey(const QNativeIpcKey &key, int initialValue = 0, QSystemSemaphore::AccessMode mode = Open)

이 함수는 생성자와 동일하게 작동합니다. 이 QSystemSemaphore 객체를 재구성합니다. 새 key 이 이전 키와 다른 경우 이 함수를 호출하는 것은 이전 키로 세마포어의 소멸자를 호출한 다음 생성자를 호출하여 새 key 로 새 세마포어를 생성하는 것과 같습니다. initialValue 및 mode 매개변수는 생성자에 대해 정의된 대로입니다.

이 함수는 네이티브 키가 다른 프로세스에서 공유된 경우에 유용합니다. 자세한 내용은 네이티브 IPC 키를 참조하세요.

QSystemSemaphore() 및 nativeIpcKey()도 참조하세요 .