JsonGetRoot
value JsonGetRoot ( value json );
Rückgabewert
Rückgabewert |
Beschreibung |
JSON-Objekt |
Das neu erstellte JSON-Objekt, das mit den Root-JSON-Daten des JSON-Objekts json geladen wurde. |
FALSE / false / 0 |
Das JSON-Objekt json ist ungültig. |
Parameter
jsonArray
Das JSON-Objekt, dessen Root-JSON-Daten ausgelesen werden soll.
Bemerkungen
Erzeugt ein JSON-Objekt, das mit dem Inhalt des Root-JSON-Daten des JSON-Objekts json geladen wird. Wird das JSON-Objekt nicht mehr benötigt, so sollte mit JsonClose zerstört werden.
Diese Funktion ist nur dann sinnvoll
anwendbar, wenn das übergebene JSON-Objekt json
ein gültiges Kind-JSON-Objekt eines gültigen Eltern-JSON-Objekts
ist. Es also das Result einer Json-Funktion ist, die als Ergebnis das
Kind eines Eltern-Objekts lieferte - wie z.B. JsonGetArray.
Die Funktion JsonGetRoot liefert
immer das erreichbarste Root-JSON-Objekt einer Eltern-Kind-Beziehung.
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 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 //string strJson; value product, root; product = JsonGetObject(json, "Produktliste.Produkt[1]"); if (product != null) root = JsonGetRoot(product); strJson = JsonToString(root); //Inhalt von strJson: //{ // "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 // } // ] // } //} end JsonClose(json);
Siehe auch JsonGetArray, JsonGetBool, JsonGetNumber, JsonGetObject, JsonGetString, JsonGetSize, JsonGetArraySize, JsonGetType