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