Migration - Smarthome-Components

IPS_GetVariableIDByName
integer IPS_GetVariableIDByName ( string $VariablenName , integer $ParentID )
Parameterliste
VariablenName Zu suchender VariablenName
ParentID Objekt, in deren Unterobjekten gesucht werden soll
Rückgabewerte
ID der gefundenen Variable, sonst FALSE
Beschreibung
Der Befehl versucht die ID der Variablen mit dem Namen VariablenName, deren übergeordnetes Objekt die ID
ParentID besitzt, zu ermitteln. Es wird die ID der ersten gefundenen Variablen verwendet, deren Name mit
VariablenName übereinstimmt. Falls eine solche Variable gefunden wurde, wird deren ID zurückgemeldet, andernfalls
FALSE.
Da hier im Gegensatz zu IPS_GetVariableID ein zusätzliches Kriterium (ParentID) bei der Suche verwendet wird, ist die
Wahrscheinlichkeit die richtige ID zu finden erheblich größer. Trotzdem gilt:
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
$VarID = @IPS_GetVariableIDByName("Regenmenge", $ParentID);
if ($VarID === false)
else
echo "Variable nicht gefunden!";
echo "Die Variablen-ID lautet: ". $VarID;