Dokumentation
SetValue
variant SetValue (int $VariablenID, variant $Wert)
Parameterliste
| VariablenID | ID der Variable |
| Wert | Neuer Wert der Variable |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion schreibt den neuen Wert Wert in die IP-Symcon Variable mit der ID VariablenID. Es ist darauf zu achten, dass der Typ des Wertes zum Typ der Variablen passt. Ist die Zielvariable vom Typ String, so sollte auch Wert vom Typ String sein.
Falls der Typ der Variablen und des Wertes nicht übereinstimmen, versucht PHP eine geeignete Konvertierung vorzunehmen. Das Ergebnis dieser Konvertierung kann aber vom erwarteten Ergebnis abweichen. Es ist daher besser von vornherein den richtigen Typ zu übergeben.
Beispiel
SetValue(29117, true); // Boolean-Variable: Merker für Schulferien setzen
SetValue(46250, $aktuelles_Projekt); // String-Variable: z.B. "Regenerfassung"