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 创建一个 semaphore。如果系统中还没有标识为key 的寄存器，则会创建该寄存器，并将其资源计数设置为initialValue 。但如果系统中已经有标识为key 的寄存器，则会使用该寄存器，并忽略initialValue 。

mode 参数仅在 Unix 系统中使用，用于处理进程崩溃后 semaphore 仍然存在的情况。在这种情况下，下一个分配具有相同key 的 semaphore 的进程将获得在崩溃中幸存的 semaphore，除非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()，进程正常退出时也不会释放该资源。这将是一个程序错误，可能会导致试图获取相同资源的另一个进程陷入僵局。在 Unix 中，在调用析构函数前未释放的已获取资源会在进程退出时自动释放。

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

返回分配给此系统 semaphore 的传统密钥。密钥是其他进程访问 Semaphore 的名称。

另请参阅 setKey()。

QNativeIpcKey QSystemSemaphore::nativeIpcKey() const

返回分配给此系统 semaphore 的密钥。密钥是一个名称，其他进程可以通过它访问该 semaphore。

您可以使用本地密钥访问非 Qt 创建的系统 semaphore，或授予非 Qt 应用程序访问权。更多信息，请参阅本地 IPC 密钥。

另请参阅 setNativeKey().

bool QSystemSemaphore::release(int n = 1)

释放由 semaphore 保护的n 资源。除非出现系统错误，否则返回true 。

示例创建一个有五个资源的系统信号；获取所有资源，然后释放所有资源。

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

除了已经存在的五个资源外，现在又有十个新的资源由该信号守护。通常情况下，您不会使用此函数来创建更多资源。

另请参阅 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()。