QSystemSemaphore Class

Dokumentation der Mitgliedsfunktionen

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

Fordert eine System-Semaphore für die angegebene key an. Die Parameter initialValue und mode werden nach den folgenden Regeln verwendet, die systemabhängig sind.

Unter Unix wird, wenn mode gleich Open ist und das System bereits über einen Semaphor verfügt, der durch key identifiziert wird, dieser Semaphor verwendet, und die Ressourcenzahl des Semaphors wird nicht geändert, d. h. initialValue wird ignoriert. Wenn das System jedoch noch keinen Semaphor mit der Kennung key hat, wird ein neuer Semaphor für diesen Schlüssel angelegt und seine Ressourcenzahl auf initialValue gesetzt.

Unter Unix wird, wenn mode Create ist und das System bereits über einen Semaphor mit der Kennung key verfügt, dieser Semaphor verwendet und seine Ressourcenzahl auf initialValue gesetzt. Wenn das System nicht bereits über einen Semaphor mit der Kennung key verfügt, wird ein neuer Semaphor für diesen Schlüssel erstellt und seine Ressourcenzahl auf initialValue gesetzt.

Unter Windows wird mode ignoriert, und das System versucht immer, einen Semaphor für den angegebenen key zu erstellen. Wenn das System noch nicht über einen Semaphor mit der Bezeichnung key verfügt, erstellt es den Semaphor und setzt seine Ressourcenzahl auf initialValue. Wenn das System jedoch bereits über einen Semaphor mit der Bezeichnung key verfügt, verwendet es diesen Semaphor und ignoriert initialValue.

Der Parameter mode wird nur in Unix-Systemen verwendet, um den Fall zu behandeln, daß ein Semaphor einen Prozeßabsturz überlebt. In diesem Fall erhält der nächste Prozess, der einen Semaphor mit demselben key zuweist, den Semaphor, der den Absturz überlebt hat, und sofern mode nicht Create ist, wird der Ressourcenzähler nicht auf initialValue zurückgesetzt, sondern behält den Anfangswert, der ihm vom abgestürzten Prozess gegeben wurde.

Siehe auch acquire() und key().

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

Fordert einen System-Semaphor an, der durch den Legacy-Schlüssel key identifiziert wird.

[noexcept] QSystemSemaphore::~QSystemSemaphore()

Der Destruktor zerstört das Objekt QSystemSemaphore, aber der zugrunde liegende System-Semaphor wird nicht aus dem System entfernt, es sei denn, diese Instanz von QSystemSemaphore ist die letzte, die für diesen System-Semaphor existiert.

Zwei wichtige Nebeneffekte des Destruktors hängen vom System ab. Wenn unter Windows acquire() für diesen Semaphor aufgerufen wurde, aber nicht release(), wird release() nicht vom Destruktor aufgerufen, noch wird die Ressource freigegeben, wenn der Prozess normal beendet wird. Dies wäre ein Programmfehler, der zu einer Blockade eines anderen Prozesses führen könnte, der versucht, die gleiche Ressource zu erwerben. Unter Unix werden erworbene Ressourcen, die nicht freigegeben werden, bevor der Destruktor aufgerufen wird, automatisch freigegeben, wenn der Prozess beendet wird.

bool QSystemSemaphore::acquire()

Erwirbt eine der von dieser Semaphore bewachten Ressourcen, falls eine verfügbar ist, und gibt true zurück. Wenn alle Ressourcen, die von dieser Semaphore bewacht werden, bereits erworben wurden, blockiert der Aufruf, bis eine von ihnen von einem anderen Prozess oder Thread freigegeben wird, der eine Semaphore mit demselben Schlüssel besitzt.

Wenn false zurückgegeben wird, 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 wenn ja, welcher Fehler es war.

Siehe auch errorString().

QString QSystemSemaphore::errorString() const

Gibt eine Textbeschreibung des letzten aufgetretenen Fehlers zurück. Wenn error() ein error value zurückgibt, rufen Sie diese Funktion auf, um eine Textzeichenkette zu erhalten, die den Fehler beschreibt.

Siehe auch error().

QString QSystemSemaphore::key() const

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

Siehe auch setKey().

QNativeIpcKey QSystemSemaphore::nativeIpcKey() const

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

Sie können den nativen Schlüssel verwenden, um auf System-Semaphoren zuzugreifen, die nicht von Qt erstellt wurden, oder um Nicht-Qt-Anwendungen Zugriff zu gewähren. Siehe Native IPC-Schlüssel für weitere Informationen.

Siehe auch setNativeKey().

bool QSystemSemaphore::release(int n = 1)

Gibt n Ressourcen frei, die von der Semaphore bewacht werden. Gibt true zurück, es sei denn, es liegt ein Systemfehler vor.

Beispiel: Erzeugen eines System-Semaphors mit fünf Ressourcen; Erfassen aller Ressourcen und anschließendes Freigeben aller Ressourcen.

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 "erzeugen". Fügen Sie zum Beispiel unmittelbar nach der obigen Anweisungsfolge die Anweisung ein:

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

Zehn neue Ressourcen werden nun von dem Semaphor bewacht, zusätzlich zu den fünf, die bereits vorhanden waren. Normalerweise würden Sie diese Funktion nicht verwenden, um weitere Ressourcen zu erzeugen.

Siehe auch acquire().

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

Diese Funktion funktioniert genauso wie der Konstruktor. Sie rekonstruiert dieses QSystemSemaphore Objekt. Wenn sich der neue key vom alten Schlüssel unterscheidet, ist der Aufruf dieser Funktion gleichbedeutend mit dem Aufruf des Destruktors des Semaphors mit dem alten Schlüssel und dem anschließenden 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.

Siehe auch QSystemSemaphore() und key().

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

Diese Funktion funktioniert genauso wie der Konstruktor. Sie rekonstruiert dieses QSystemSemaphore Objekt. Wenn sich der neue key vom alten Schlüssel unterscheidet, ist der Aufruf dieser Funktion gleichbedeutend mit dem Aufruf des Destruktors des Semaphors mit dem alten Schlüssel und dem anschließenden 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 freigegeben wurde. Siehe Native IPC-Schlüssel für weitere Informationen.

Siehe auch QSystemSemaphore() und nativeIpcKey().