JsonInsertArray
value JsonInsertArray ( value json, value Index, string strName );
Rückgabewert
Rückgabewert |
Beschreibung |
JSONARRAY-Objekt |
Das neu erstellte JSONARRAY-Objekt, das in das JSON-Objekt json eingefügt wurde. |
FALSE / false / 0 |
Das Einfügen eines neuen JSONARRAY-Objekts ist fehlgeschlagen. |
Parameter
json
Das gültige JSON-Objekt, in das ein neues leeres JSONARRAY-Objekt eingefügt werden soll.
Index
Die Position im JSON-Objekt json an der das neue leere JSONARRAY-Objekt eingefügt werden soll. Für das erste JSON-Element gilt: Index = 0.
strName
Der Name des JSONARRAY-Objekts, das eingefügt werden soll. Der Name darf keine Pfadangabe sein.
Bemerkungen
Erzeugt ein leeres JSONARRAY-Objekt und fügt es als Element strName an der Position Index in das JSON-Objekt json ein. Das erzeugte JSONARRAY-Objekt wird automatisch geschlossen, wenn das Eltern-JSON-Objekt json geschlossen wird, es kann aber auch vorher mit JsonArrayClose geschlossen werden.
Das erzeugte JSONARRAY-Objekt (hier jsonResult genannt) ist ein Referenzobjekt zum JSONARRAY-Objekt (hier jsonNewInserted genannt) das im JSON-Objekt json eingefügt wurde. Das bedeutet, jede Änderung am JSONARRAY-Objekt jsonResult wirkt sich direkt auf das JSONARRAY-Objekt jsonNewInserted im JSON-Objekt json aus. Wird das JSONARRAY-Objekt jsonResult mit JsonArrayClose geschlossen, so hat dies keine Auswirkung auf das JSONARRAY-Objekt jsonNewInserted im JSON-Objekt json.
Beim Beenden eines laufenden Projekts schließt Victory automatisch alle nicht geschlossenen JSON/JSONARRAY-Objekte.
Beispiel
//Inhalt von "data.json": //{ // "Boolean": true, // "Number": 3.14, // "WithoutContent": null, // "String": "xyz", // "Array": [ // 1, // true, // null, // "abc" // ] //} value json; if (!JsonCreateFromFile(json, "data.json")) return (false); end value jsonArray; jsonArray = JsonInsertArray(json, 1, "Values"); for (value i = 1; i <= 4; i ++) JsonArrayAddNumber(jsonArray, i); end string strJson; strJson = JsonToString(json); //Inhalt von strJson: //{ // "Boolean": true, // "Values": [ // 1, // 2, // 3, // 4 // ], // "Number": 3.14, // "WithoutContent": null, // "String": "xyz", // "Array": [ // 1, // true, // null, // "abc" // ] //} JsonClose(json);
Siehe auch JsonInsertBool,
JsonInsertNull,
JsonInsertNumber,
JsonInsertObject,
JsonInsertString