Migration - Smarthome-Components

IPS_SemaphoreEnter
boolean IPS_SemaphoreEnter ( string $Name , integer $Wartezeit )
Parameterliste
Name Name, der die Semaphore beschreibt
Wartezeit Millisekunden, die gewartet wird, bis der Befehl abbricht
Rückgabewerte
TRUE, wenn die Semaphore betreten wurde. FALSE, wenn die Semaphore vor Ablauf der Wartezeit nicht betreten
werden konnte
Beschreibung
Dieser Befehl setzt ein Semaphor (ein Zeichen mit Signalwirkung), das dazu verwendet werden kann, den Start anderer
Skripte zu verhindern. Ein Skript kann sich so vor konkurrierenden anderen Skripten schützen und natürlich auch vor
anderen Instanzen von sich selbst.
Der Befehl versucht, das Semaphor mit dem Namen SemaphorName zu setzen. Existiert das Semaphor bereits, wird die
Abarbeitung des Skripts für die Zeitdauer Wartezeit (in Millisekunden) ausgesetz. Danach wird noch ein weiterer
Versuch unternommen.
In IP-Symcon können grundsätzlich mehrere Skripte gleichzeitig laufen. Solange ein Skript keinen exklusiven Zugriff auf
Variablen oder System-Ressourcen benötigt, stellt dieser Fall kein Problem dar. Falls aber ein exklusiver Zugriff
unumgänglich ist, kann mit dem Befehl ein Semaphor gesetzt werden. Der Befehl prüft zuerst, ob das Semaphor mit dem
angegebenen Namen bereits gesetzt ist. Existiert es noch nicht, wird es durch den Befehl gesetzt und liefert TRUE als
Rückmeldung. Alle anderen Skripte, die danach versuchen das selbe Semaphor zu setzen, müssen eine Warteschleife der
Dauer Wartezeit durchlaufen. Nach Ablauf der Wartezeit versucht der Befehl erneut das Semaphor zu setzen. Ist er dabei
erfolgreich, wird TRUE zurückgemeldet, andernfalls FALSE. Wenn man gewährleisten will, dass während der Laufzeit
eines Skripts die von ihm verwendeten Daten nicht von anderen, gleichzeitig laufenden Skripten verfälscht werden, kann
man diesen Befehl verwenden, um sich exklusiven Zugriff zu sichern.
Bei der Verwendung dieses Befehls ist darauf zu achten, dass das Semaphor möglichst bald wieder zurückgesetzt wird.
Beispiel
if (IPS_SemaphoreEnter("KritischerPunkt", 1000))
{
}
else
{
}
// ...Kritische Befehle ausführen
//Semaphore wieder freigeben!
IPS_SemaphoreLeave("KritischerPunkt");
// ...Keine ausführung Möglich. Ein anderes Skript nutzt den "KritischenPunkt"
// für länger als 1 Sekunde, sodass unsere Wartezeit überschritten wird.