QSystemSemaphore Class

멤버 함수 문서

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

지정된 key 에 대한 시스템 세마포어를 요청합니다. 매개변수 initialValue 와 mode 는 시스템에 따라 달라지는 다음 규칙에 따라 사용됩니다.

유닉스에서 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 키 (Native IPC Keys )를 참조하십시오.

QSystemSemaphore() 및 nativeIpcKey()도 참조하십시오 .