Migration - Smarthome-Components

IPS_GetObjectIDByName
integer IPS_GetObjectIDByName ( string $ObjektName , integer $ParentID )
Parameterliste
ObjektName Zu suchender ObjektName
ParentID Objekt, in dessen Unterobjekten gesucht werden soll
Rückgabewerte
ID des gefundenen Objekts, sonst FALSE
Beschreibung
Der Befehl versucht die ID des Objekts mit dem Namen ObjektName, dessen übergeordnetes Objekt die ID ParentID
besitzt, zu ermitteln. Es wird die ID des ersten gefundenen Objekts verwendet, dessen Name mit ObjektName
übereinstimmt. Falls ein solches Objekt 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 der
Befehl 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 genau Funktionsweise dieses Operators können Sie dem PHP Handbuch
entnehmen.
Beispiel
$ObjektID = @IPS_GetObjectIDByName("Regenerfassung", $ParentID);
if ($ObjektID === false)
else
echo "Objekt nicht gefunden!";
echo "Die Objekt-ID lautet: ". $ObjektID;