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

Die Json-Funktionen

Siehe auch JsonArrayInsertBool, JsonArrayInsertNull, JsonArrayInsertNumber, JsonArrayInsertObject, JsonArrayInsertString