Migration - Smarthome-Components

IPS_GetInstanceIDByName
integer IPS_GetInstanceIDByName ( string $InstanzName , integer $ParentID )
Parameterliste
InstanzName Zu suchender InstanzName
ParentID Objekt, in deren Unterobjekten gesucht werden soll
Rückgabewerte
ID der gefundenen Instanz, sonst FALSE
Beschreibung
Der Befehl versucht die ID der Instanz mit dem Namen InstanzName, deren übergeordnetes Objekt die ID ParentID
besitzt, zu ermitteln. Es wird die ID der ersten gefundenen Instanz verwendet, deren Name mit InstanzName
übereinstimmt. Falls eine solche Instanz 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
$InstanzID = @IPS_GetInstanceIDByName("Regenmenge", $ParentID);
if ($InstanzID === false)
else
echo "Instanz nicht gefunden!";
echo "Die Instanz-ID lautet: ". $InstanzID;