JsonArrayGetArray

value JsonArrayGetArray ( value jsonArray, value Index );

Rückgabewert

Rückgabewert	Beschreibung
JSONARRAY-Objekt	Das neu erstellte JSONARRAY-Objekt, das mit den JSONARRAY-Daten des Elements im JSONARRAY-Objekt jsonArray geladen wurde.
FALSE / false / 0	Das Auslesen des JSONARRAY-Elements ist fehlgeschlagen. Es wurde kein Element an der Position Index gefunden bzw. das Element an der Position ist kein JSONARRAY-Element.

Parameter

jsonArray

Das JSONARRAY-Objekt, von dem ein JSONARRAY-Element ausgelesen werden soll.

Index

Die Position des JSONARRAY-Elements, das aus dem JSONARRAY-Objekt jsonArray ausgelesen werden soll. Für das erste JSONARRAY-Element gilt: Index = 0.

Bemerkungen

Erzeugt ein JSONARRAY-Objekt, das mit dem Inhalt des JSONARRAY-Elements geladen wird, das sich an der Position Index im JSONARRAY-Objekt jsonArray befindet. Wird das JSONARRAY-Objekt nicht mehr benötigt, so sollte mit JsonArrayClose zerstört werden.

Das zugelieferte JSONARRAY-Objekt (hier jsonResult genannt) ist ein Referenzobjekt zum JSONARRAY-Objekt (hier jsonFound genannt) das im JSONARRAY-Objekt jsonArray gefunden wurde. Das bedeutet, jede Änderung am JSONARRAY-Objekt jsonResult wirkt sich direkt auf das JSONARRAY-Objekt jsonFound im JSONARRAY-Objekt jsonArray aus. Wird das JSONARRAY-Objekt jsonResult mit JsonArrayClose geschlossen, so hat dies keine Auswirkung auf das JSONARRAY-Objekt jsonFound im JSONARRAY-Objekt jsonArray.

Beim Beenden eines laufenden Projekts schließt Victory automatisch alle nicht geschlossenen JSON/JSONARRAY-Objekte, wird z.B. ein JSONARRAY-Objekt mit JsonArrayCreate im _InitApplication erzeugt und dieses dann dauerhaft verwendet, so muss dieses nicht explizit im _ExitApplication geschlossen werden.

Beispiel

//Inhalt von "array.json":
//{
//  "Array": [
//    [
//      1,
//      2
//    ],
//    [
//      3,
//      4
//    ],
//  ]
//}
value json;
if (!JsonCreateFromFile(json, "array.json"))
    return (false);
end
value jsonArray;
jsonArray = JsonGetArray(json, "Array");

value addedArray = JsonArrayAddArray(jsonArray);
JsonArrayAddNumber(addedArray, 5);
JsonArrayAddNumber(addedArray, 6);

string strJson;
strJson = JsonToString(json);
//Inhalt von strJson:
//{
//  "Array": [
//    [
//      1,
//      2
//    ],
//    [
//      3,
//      4
//    ],
//    [
//      5,
//      6
//    ]
//  ]
//}
JsonClose(json);
 

Die Json-Funktionen

Siehe auch JsonArrayGetBool, JsonArrayGetNumber, JsonArrayGetObject, JsonArrayGetSize, JsonArrayGetString, JsonArrayGetType, JsonArrayIsNull