JsonArrayInsertArray
value JsonArrayInsertArray ( value jsonArray, value Index );
Rückgabewert
Rückgabewert |
Beschreibung |
JSONARRAY-Objekt |
Das neu erstellte JSONARRAY-Objekt, das in das JSONARRAY-Objekt jsonArray eingefügt wurde. |
FALSE / false / 0 |
Das Einfügen eines neuen JSONARRAY-Objekts ist fehlgeschlagen. |
Parameter
jsonArray
Das gültige JSONARRAY-Objekt, in das ein neues leeres JSONARRAY-Objekt eingefügt werden soll.
Index
Die Position im JSONARRAY-Objekt jsonArray an der das neue leere JSONARRAY-Objekt eingefügt werden soll. Für das erste JSONARRAY-Element gilt: Index = 0.
Bemerkungen
Erzeugt ein leeres JSONARRAY-Objekt und fügt es an der Position Index in das JSONARRAY-Objekt jsonArray ein. Das erzeugte JSONARRAY-Objekt wird automatisch geschlossen, wenn das Eltern-JSONARRAY-Objekt jsonArray geschlossen wird, 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 JSONARRAY-Objekt jsonArray eingefügt wurde. Das bedeutet, jede Änderung am JSONARRAY-Objekt jsonResult wirkt sich direkt auf das JSONARRAY-Objekt jsonNewInserted im JSONARRAY-Objekt jsonArray aus. Wird das JSONARRAY-Objekt jsonResult mit JsonArrayClose geschlossen, so hat dies keine Auswirkung auf das JSONARRAY-Objekt jsonNewInserted im JSONARRAY-Objekt jsonArray.
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, insertedArray; jsonArray = JsonGetArray(json, "Array"); insertedArray = JsonArrayInsertArray(jsonArray, 1); JsonArrayAddNumber(insertedArray, 2); JsonArrayAddNumber(insertedArray, 3); string strJson; strJson = JsonToString(json); //Inhalt von strJson: //{ // "Boolean": true, // "Number": 3.14, // "WithoutContent": null, // "String": "xyz", // "Array": [ // 1, // [ // 2, // 3 // ], // true, // null, // "abc" // ] //} JsonArrayInsertBool(jsonArray, 2, false); JsonArrayInsertNumber(jsonArray, 3, e); JsonArrayInsertString(jsonArray, 4, "def"); JsonArrayInsertNull(jsonArray, 4); strJson = JsonToString(json); //Inhalt von strJson: //{ // "Boolean": true, // "Number": 3.14, // "WithoutContent": null, // "String": "xyz", // "Array": [ // 1, // [ // 2, // 3 // ], // false, // 2.718282, // null, // "def", // true, // null, // "abc" // ] //}JsonClose(json);
Siehe auch JsonArrayInsertBool, JsonArrayInsertNull, JsonArrayInsertNumber, JsonArrayInsertObject, JsonArrayInsertString