QSystemSemaphore Class

Dokumentation der Mitgliedsfunktionen

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

Fordert ein System-Semaphor für den angegebenen key an. Die Parameter initialValue und mode werden gemäß den folgenden Regeln verwendet, die systemabhängig sind.

Unter Unix gilt: Wenn der Schlüssel „ mode “ den Wert „ Open “ hat und das System bereits über ein Semaphor verfügt, das durch „ key “ identifiziert wird, wird dieses Semaphor verwendet, und die Ressourcenanzahl des Semaphors wird nicht geändert, d. h., „ initialValue “ wird ignoriert. Wenn das System jedoch noch kein Semaphor mit der Kennung key besitzt, erstellt es ein neues Semaphor für diesen Schlüssel und setzt dessen Ressourcenzahl auf initialValue.

Unter Unix gilt: Wenn der „ mode “ Create lautet und das System bereits über ein Semaphor mit der Kennung key verfügt, wird dieses Semaphor verwendet und seine Ressourcenanzahl auf initialValue gesetzt. Verfügt das System noch nicht über ein Semaphor mit der Kennung key, erstellt es ein neues Semaphor für diesen Schlüssel und setzt dessen Ressourcenanzahl auf initialValue.

Unter Windows wird „ mode “ ignoriert, und das System versucht immer, ein Semaphor für den angegebenen Schlüssel „ key “ zu erstellen. Verfügt das System noch nicht über ein Semaphor mit der Kennung „ key “, erstellt es das Semaphor und setzt dessen Ressourcenanzahl auf „ initialValue “. Verfügt das System jedoch bereits über ein Semaphor mit der Kennung „ key “, verwendet es dieses Semaphor und ignoriert „ initialValue “.

Der Parameter „ mode “ wird nur in Unix-Systemen verwendet, um den Fall zu behandeln, in dem ein Semaphor einen Prozessabsturz übersteht. In diesem Fall erhält der nächste Prozess, der ein Semaphor mit demselben „ key “ zuweist, das Semaphor, das den Absturz überstanden hat, und sofern „ mode “ nicht auf „ Create “ gesetzt ist, wird die Ressourcenanzahl nicht auf „ initialValue “ zurückgesetzt, sondern behält den ursprünglichen Wert bei, der ihr vom abgestürzten Prozess zugewiesen wurde.

Siehe auch acquire() und key().

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

Fordert ein System-Semaphor an, das durch den Legacy-Schlüssel „ key “ identifiziert wird.

[noexcept] QSystemSemaphore::~QSystemSemaphore()

Der Destruktor löscht das QSystemSemaphore -Objekt, doch das zugrunde liegende System-Semaphor wird erst dann aus dem System entfernt, wenn diese Instanz von QSystemSemaphore die letzte ist, die für dieses System-Semaphor existiert.

Zwei wichtige Nebeneffekte des Destruktors hängen vom jeweiligen System ab. Unter Windows wird, wenn für dieses Semaphor ` acquire()` aufgerufen wurde, aber nicht ` release()`, weder ` release()` vom Destruktor aufgerufen, noch wird die Ressource freigegeben, wenn der Prozess normal beendet wird. Dies wäre ein Programmfehler, der zu einem Deadlock in einem anderen Prozess führen könnte, der versucht, dieselbe Ressource zu erwerben. Unter Unix werden erworbene Ressourcen, die nicht vor dem Aufruf des Destruktors freigegeben wurden, beim Beenden des Prozesses automatisch freigegeben.

bool QSystemSemaphore::acquire()

Erwirbt eine der von diesem Semaphor geschützten Ressourcen, sofern eine verfügbar ist, und gibt ` true` zurück. Wenn alle von diesem Semaphor geschützten Ressourcen bereits erworben wurden, blockiert der Aufruf, bis eine davon von einem anderen Prozess oder Thread freigegeben wird, der über ein Semaphor mit demselben Schlüssel verfügt.

Wird „false“ zurückgegeben, ist ein Systemfehler aufgetreten. Rufen Sie ` error()` auf, um einen Wert von ` QSystemSemaphore::SystemSemaphoreError ` zu erhalten, der angibt, welcher Fehler aufgetreten ist.

Siehe auch ` release()`.

QSystemSemaphore::SystemSemaphoreError QSystemSemaphore::error() const

Gibt einen Wert zurück, der angibt, ob ein Fehler aufgetreten ist und, falls ja, um welchen Fehler es sich handelt.

Siehe auch „ errorString()“.

QString QSystemSemaphore::errorString() const

Gibt eine Textbeschreibung des zuletzt aufgetretenen Fehlers zurück. Wenn error() einen Wert vom Typ „ error value “ zurückgibt, rufen Sie diese Funktion auf, um eine Textzeichenfolge zu erhalten, die den Fehler beschreibt.

Siehe auch ` error()`.

QString QSystemSemaphore::key() const

Gibt den diesem System-Semaphor zugewiesenen Legacy-Schlüssel zurück. Der Schlüssel ist der Name, unter dem von anderen Prozessen auf den Semaphor zugegriffen werden kann.

Siehe auch ` setKey()`.

QNativeIpcKey QSystemSemaphore::nativeIpcKey() const

Gibt den diesem System-Semaphor zugewiesenen Schlüssel zurück. Der Schlüssel ist der Name, unter dem von anderen Prozessen aus auf den Semaphor zugegriffen werden kann.

Sie können den nativen Schlüssel verwenden, um auf Systemsemaphoren zuzugreifen, die nicht von Qt erstellt wurden, oder um Nicht-Qt-Anwendungen Zugriff zu gewähren. Weitere Informationen finden Sie unter „Native IPC-Schlüssel “.

Siehe auch ` setNativeKey()`.

bool QSystemSemaphore::release(int n = 1)

Gibt die vom Semaphor geschützten Ressourcen „ n “ frei. Gibt „ true “ zurück, sofern kein Systemfehler vorliegt.

Beispiel: Erstellen Sie ein System-Semaphor mit fünf Ressourcen; sichern Sie sich alle Ressourcen und geben Sie sie anschließend wieder frei.

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

Diese Funktion kann auch Ressourcen „erstellen“. Angenommen, wir fügen unmittelbar im Anschluss an die obige Anweisungsfolge folgende Anweisung hinzu:

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

Zusätzlich zu den fünf bereits vorhandenen Ressourcen werden nun zehn neue Ressourcen durch das Semaphor geschützt. Normalerweise würden Sie diese Funktion nicht zum Erstellen weiterer Ressourcen verwenden.

Siehe auch ` acquire()`.

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

Diese Funktion verhält sich genauso wie der Konstruktor. Sie rekonstruiert dieses QSystemSemaphore -Objekt. Wenn sich der neue Schlüssel key vom alten Schlüssel unterscheidet, entspricht der Aufruf dieser Funktion dem Aufruf des Destruktors des Semaphors mit dem alten Schlüssel, gefolgt vom Aufruf des Konstruktors, um einen neuen Semaphor mit dem neuen Schlüssel key zu erstellen. Die Parameter initialValue und mode sind wie für den Konstruktor definiert.

Siehe auch QSystemSemaphore() und key().

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

Diese Funktion verhält sich genauso wie der Konstruktor. Sie baut dieses QSystemSemaphore -Objekt neu auf. Wenn sich der neue key vom alten Schlüssel unterscheidet, entspricht der Aufruf dieser Funktion dem Aufruf des Destruktors des Semaphors mit dem alten Schlüssel, gefolgt vom Aufruf des Konstruktors, um einen neuen Semaphor mit dem neuen key zu erstellen. Die Parameter initialValue und mode sind wie für den Konstruktor definiert.

Diese Funktion ist nützlich, wenn der native Schlüssel von einem anderen Prozess gemeinsam genutzt wurde. Weitere Informationen finden Sie unter „Native IPC-Schlüssel “.

Siehe auch „ QSystemSemaphore()“ und „ nativeIpcKey()“.