Was können wir verbessern?

Dokumentation

IPS_GetEventIDByName

integer IPS_GetEventIDByName ( string $EreignisName, integer $ÜbergeordneteID )

Parameterliste

EreignisName Zu suchender EreignisName
ÜbergeordneteID Objekt, in dessen direkten Unterobjekten gesucht werden soll

Rückgabewerte

ID des gefundenen Ereignisses, sonst FALSE

Beschreibung

Die Funktion versucht die ID des Ereignisses mit dem Namen EreignisName, dessen übergeordnetes Objekt die ID ÜbergeordneteID besitzt, zu ermitteln. Es wird die ID des ersten gefundenen Ereignisses verwendet, dessen Name mit EreignisName übereinstimmt. Falls ein solches Ereignis gefunden wurde, wird dessen ID zurückgemeldet, andernfalls FALSE.

Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann die Funktion eine falsche ID zurückmelden.

Diese Funktion generiert eine Warnung, sollte der Name nicht gefunden werden. Benutzen Sie den @ Operator, falls Sie diese Meldung unterdrücken wollen. Die genaue Funktionsweise dieses Operators kann dem PHP Handbuch entnommen werden.

Beispiel

$EreignisID = @IPS_GetEventIDByName("TimerABC", $ParentID);
if ($EreignisID === false)
    echo "Ereignis nicht gefunden!";
else
    echo "Die Ereignis-ID lautet: ". $EreignisID;