IPS_GetCategoryIDByName

 int IPS_GetCategoryIDByName (string $KategorieName, int $ÜbergeordneteID) 

Parameterliste

Rückgabewert

ID der gefundenen Kategorie, sonst FALSE

Beschreibung

Die Funktion versucht die ID der Kategorie mit dem Namen KategorienName, deren übergeordnetes Objekt die ID ÜbergeordneteID besitzt, zu ermitteln. Es wird die ID der ersten gefundenen Kategorie verwendet, deren Name mit KategorienName übereinstimmt. Falls eine solche Kategorie 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 die Funktion eine falsche ID zurückgeben.

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

$KategorieID = @IPS_GetCategoryIDByName("Regenerfassung", $ÜbergeordneteID);
if ($KategorieID === false)
    echo "Kategorie nicht gefunden!";
else
    echo "Die Kategorien-ID lautet: ". $KategorieID;