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 参数仅在Unix系统中使用，用于处理信号量在进程崩溃后仍存活的情况。 在这种情况下，下一个尝试分配具有相同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()，且当进程正常退出时，该资源也不会被释放。 这将构成一个程序错误，可能导致另一个试图获取同一资源的进程陷入死锁。在 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

返回分配给此系统信号量的旧式键。该键是其他进程访问该信号量时所使用的名称。

另请参阅 ` setKey()`。

QNativeIpcKey QSystemSemaphore::nativeIpcKey() const

返回分配给此系统信号量的键。该键是其他进程访问该信号量时所使用的名称。

您可以使用本机键访问非由 Qt 创建的系统信号量，或向非 Qt 应用程序授予访问权限。有关更多信息，请参阅“本机 IPC 键”。

另请参阅 ` setNativeKey()`。

bool QSystemSemaphore::release(int n = 1)

释放由该信号量保护的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()。