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

Die Json-Funktionen

Siehe auch  JsonInsertBool, JsonInsertNull, JsonInsertNumber, JsonInsertObject, JsonInsertString