JsonInsertObject

value JsonInsertObject ( value json, value Index, string strName );

Rückgabewert

Rückgabewert	Beschreibung
JSON-Objekt	Das neu erstellte JSON-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 JSON-Objekt eingefügt werden soll.

Index

Die Position im JSON-Objekt json an der das neue leere JSON-Objekt eingefügt werden soll. Für das erste JSON-Element gilt: Index = 0.

strName

Der Name des JSON-Objekts, das eingefügt werden soll. Der Name darf keine Pfadangabe sein.

Bemerkungen

Erzeugt ein leeres JSON-Objekt und fügt es als Element strName an der Position Index in das JSON-Objekt json ein. Das erzeugte JSON-Objekt wird automatisch geschlossen, wenn das Eltern-JSON-Objekt json geschlossen wird, es 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 JSON-Objekt json eingefügt wurde. Das bedeutet, jede Änderung am JSON-Objekt jsonResult wirkt sich direkt auf das JSON-Objekt jsonNewInserted im JSON-Objekt json aus. Wird das JSON-Objekt jsonResult mit JsonClose geschlossen, so hat dies keine Auswirkung auf das JSON-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
JsonInsertBool(json, 2, "Boolean Value", false);

JsonInsertNull(json, 3, "Empty");

JsonInsertString(json, 4, "Text", "abc");

value jsonObject;
jsonObject = JsonInsertObject(json, 5, "Numbers");
JsonAddNumber(jsonObject, "Pi", pi);
JsonAddNumber(jsonObject, "Euler number", e);

string strJson;
strJson = JsonToString(json);
//Inhalt von strJson:
//{
//  "Boolean": true,
//  "Values": [
//    1,
//    2,
//    3,
//    4
//  ],
//  "Boolean Value": false,
//  "Empty": null,
//  "Text": "abc",
//  "Numbers": {
//    "Pi": 3.141593,
//    "Euler number": 2.718282
//  },
//  "Number": 3.14,
//  "WithoutContent": null,
//  "String": "xyz",
//  "Array": [
//    1,
//    true,
//    null,
//    "abc"
//  ]
//}
JsonClose(json);
 

Die Json-Funktionen

Siehe auch  JsonInsertArray, JsonInsertBool, JsonInsertNull, JsonInsertNumber, JsonInsertString