JsonArrayGetObject
value JsonArrayGetObject ( value jsonArray, value Index );
Rückgabewert
Rückgabewert |
Beschreibung |
JSONARRAY-Objekt |
Das neu erstellte JSON-Objekt, das mit den JSON-Daten des Elements im JSONARRAY-Objekt jsonArray geladen wurde. |
FALSE / false / 0 |
Das Auslesen des JSON-Elements ist fehlgeschlagen. Es wurde kein Element an der Position Index gefunden bzw. das Element an der Position ist kein JSON-Element. |
Parameter
jsonArray
Das JSONARRAY-Objekt, von dem ein JSON-Element ausgelesen werden soll.
Index
Die Position des JSON-Elements, das aus dem JSONARRAY-Objekt jsonArray ausgelesen werden soll. Für das erste JSONARRAY-Element gilt: Index = 0.
Bemerkungen
Erzeugt ein JSON-Objekt, das mit dem Inhalt des JSON-Elements geladen wird, das sich an der Position Index im JSONARRAY-Objekt jsonArray befindet. Wird das JSON-Objekt nicht mehr benötigt, so sollte mit JsonClose zerstört werden.
Das zugelieferte JSON-Objekt (hier jsonResult genannt) ist ein Referenzobjekt zum JSON-Objekt (hier jsonFound genannt) das im JSONARRAY-Objekt jsonArray gefunden wurde. Das bedeutet, jede Änderung am JSON-Objekt jsonResult wirkt sich direkt auf das JSON-Objekt jsonFound im JSONARRAY-Objekt jsonArray aus. Wird das JSON-Objekt jsonResult mit JsonArrayClose geschlossen, so hat dies keine Auswirkung auf das JSON-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 JSON-Objekt mit JsonArrayGetObject im _InitApplication erzeugt und dieses dann dauerhaft verwendet, so muss dieses nicht explizit im _ExitApplication geschlossen werden.
Beispiel
//Inhalt von Datei "Produktliste.json": //{ // "Produktliste": { // "Produktgruppe": "PVC-isolierte Starkstromkabel 0,6/1kV", // "Produkt": [ // { // "Type": "E-YY 4 x 6 RE", // "Aderanzahl": 4, // "Aussendurchmesser": 15, // "Belastbarkeit (Erde)": 59, // "Belastbarkeit (Luft)": 43, // "Verfügbar": true // }, // { // "Type": "E-YY 1 x 16 RE", // "Aderanzahl": 1, // "Aussendurchmesser": 11, // "Belastbarkeit (Erde)": 107, // "Belastbarkeit (Luft)": 84, // "Verfügbar": false // } // ] // } //} value json; if (!JsonCreateFromFile(json, "Produktliste.json")) return (false); end value products; products = JsonGetArray(json, "Produktliste.Produkt"); value product; product = JsonArrayGetObject(products, 0); //following function call has the same result //product = JsonArrayGetObject(json, "Produktliste.Produkt[0]"); string strJson; strJson = JsonToString(product); //Inhalt von strJson: //{ // "Type": "E-YY 4 x 6 RE", // "Aderanzahl": 4, // "Aussendurchmesser": 15, // "Belastbarkeit (Erde)": 59, // "Belastbarkeit (Luft)": 43, // "Verfügbar": true //} JsonClose(json);
Siehe auch JsonArrayGetArray, JsonArrayGetBool, JsonArrayGetNumber, JsonArrayGetSize, JsonArrayGetString, JsonArrayGetType, JsonArrayIsNull