Migration - Smarthome-Components

IPS_GetLinkIDByName
integer IPS_GetLinkIDByName ( string $LinkName , integer $ParentID )
Parameterliste
LinkName Zu suchender LinkName
ParentID Objekt, in deren Unterobjekten gesucht werden soll
Rückgabewerte
ID des gefundenen Links, sonst FALSE
Beschreibung
Der Befehl versucht die ID des Links mit dem Namen LinkName, deren übergeordnetes Objekt die ID ParentID
besitzt, zu ermitteln. Es wird die ID des ersten gefundenen Links verwendet, deren Name mit LinkName übereinstimmt.
Falls ein solcher Link gefunden wurde, wird deren ID zurückgemeldet, andernfalls FALSE.
Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann der
Befehl eine falsche ID zurückmelden.
Diese Funktion generiert eine Warung, sollte der Name nicht gefunden werden. Benutzen Sie den @ Operator, falls
Sie diese Meldung unterdrücken wollen. Die genau Funktionsweise dieses Operators können Sie dem PHP Handbuch
entnehmen.
Beispiel
$LinkID = @IPS_GetLinkIDByName("Verlinkte Regenerfassung", $ParentID);
if ($LinkID === false)
else
echo "Link nicht gefunden!";
echo "Die Link-ID lautet: ". $LinkID;
Benötigt: IP-Symcon >= 2.1