JsonAddArray

value JsonAddArray ( value json, string strName );

Rückgabewert

Rückgabewert	Beschreibung
JSONARRAY-Objekt	Das neu erstellte JSONARRAY-Objekt, das dem JSON-Objekt json hinzugefügt wurde.
FALSE / false / 0	Das Hinzufügen eines neuen JSONARRAY-Objekt's mit dem Name strName ist fehlgeschlagen.

Parameter

json

Das gültige JSON-Objekt, dem ein JSONARRAY-Objekt hinzugefügt werden soll.

strName

Der Name des JSONARRAY-Objekt's, das hinzugefügt werden soll. Der Name darf keine Pfadangabe sein.

Bemerkungen

Erzeugt ein leeres JSONARRAY-Objekt und fügt es dem gültigen JSON-Objekt json unter dem Namen strName hinzu. Der Name strName des Elements darf keine Pfadangabe enthalten. 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 jsonNewAdded genannt) das dem JSON-Objekt json hinzugefügt wurde. Das bedeutet, jede Änderung am JSONARRAY-Objekt jsonResult wirkt sich direkt auf das JSONARRAY-Objekt jsonNewAdded im JSON-Objekt json aus. Wird das JSONARRAY-Objekt jsonResult mit JsonArrayClose geschlossen, so hat dies keine Auswirkung auf das JSONARRAY-Objekt jsonNewAdded im JSON-Objekt json.

Beim Beenden eines laufenden Projekts schließt Victory automatisch alle nicht geschlossenen JSON/JSONARRAY-Objekte.

Beispiel

value json, jsonArray;
json = JsonCreate();

JsonAddBool(json, "Boolean", false);
JsonAddNumber(json, "Number", 3.14);
JsonAddNull(json, "WithoutContent");
JsonAddString(json, "String", "xyz");

jsonArray = JsonAddArray(json, "Array");
JsonArrayAddNumber(jsonArray, 1);
JsonArrayAddBool(jsonArray, true);
JsonArrayAddNull(jsonArray);
JsonArrayAddString(jsonArray, "abc");

string strJson = JsonToString(json);
//Inhalt von strJson:
//{
//  "Boolean": false,
//  "Number": 3.14,
//  "WithoutContent": null,
//  "String": "xyz",
//  "Array": [
//    1,
//    true,
//    null,
//    "abc"
//  ]
//}
JsonClose(json);
 

Die Json-Funktionen

Siehe auch  JsonAddBool, JsonAddNull, JsonAddNumber, JsonAddObject, JsonAddString