IPS_GetLinkIDByName

Benötigt: Symcon >= 2.1

 int IPS_GetLinkIDByName (string $LinkName, int $ÜbergeordneteID) 

Parameterliste

Rückgabewert

ID des gefundenen Links, sonst FALSE

Beschreibung

Die Funktion versucht, die ID des Links mit dem Namen LinkName, dessen übergeordnetes Objekt die ID ÜbergeordneteID besitzt, zu ermitteln. Es wird die ID des ersten gefundenen Links verwendet, dessen Name mit LinkName übereinstimmt. Falls ein solcher Link 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, falls der Name nicht gefunden wird. Der @-Operator kann genutzt werden, falls diese Meldung unterdrückt werden soll. Die genaue Funktionsweise dieses Operators kann dem PHP Handbuch entnommen werden.

Beispiel

$LinkID = @IPS_GetLinkIDByName("Verlinkte Regenerfassung", $ÜbergeordneteID);
if ($LinkID === false)
    echo "Link nicht gefunden!";
else
    echo "Die Link-ID lautet: ". $LinkID;