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);
 

Die Json-Funktionen

Siehe auch JsonArrayInsertArray, JsonArrayInsertBool, JsonArrayInsertNull, JsonArrayInsertNumber, JsonArrayInsertString