Mit diesem Kommando kann einem Array ein Wert gesetzt werden.
Ab der DLE-Version 2.1.2 verfügbar.
Parameter:
- Index: Gibt den Index an, an welcher Array-Stelle der Wert gesetzt werden soll. Wird kein Index angegeben, so wird der Wert an der letzen Stelle des Arrays hinzugefügt. Wird ein Index angegeben, der größer ist, als das Array, dann werden die dazwischenliegenden Indizes mit null gefüllt.
- Wert: Der Wert, welcher ins Array geschrieben werden soll.
- Datentyp: Gibt an, ob der Wert als Text, Zahl oder Boolscher-Wert in das Array geschrieben werden soll.
- Null-Verhalten: (optional)
- Wert behalten (default): Undefinierte Werte werden zu null, Leerwerte und 0 bleiben erhalten
- Null erzwingen: Undefinierte Werte sowie Leerwerte und 0/false werden zu null
- Null verbieten: Es entsteht nie ein null-Wert. Auch undefinierte Felder werden zu Leerwerten, 0 oder false
- Leerwerte unterdücken: Leere Strings, 0 und undefinierte Felder werden nicht in das JSONArray aufgenommen (ab DLE 2.1.2.031)
Sonderverhalten bei Wert:
Wird KEIN Datentyp angegeben und als Wert ein Text der entweder mit [ oder mit { beginnt, so wird der Text als JSON String geparsed. Ist dies nicht erfolgreich, dann wird der Text als String hinzugefügt.