JsonGetString

string JsonGetString ( value json, value Index / string strPath );

Rückgabewert

Rückgabewert

Beschreibung

value

Die Zeichenkette des Textelements, das sich an der Position Index im JSON-Objekt json befindet bzw. über den Pfad strPath im JSON-Objekt json erreichbar ist.

Parameter

jsonArray

Das JSON-Objekt, von dem der string Wert eines Elements ausgelesen werden soll.

Index

Die Position des Textelements, das aus dem JSON-Objekt json ausgelesen werden soll. Für das erste JSON-Element gilt: Index = 0.

strPath

Der Pfad des Textelements, das aus dem JSON-Objekt json ausgelesen werden soll.

Bemerkungen

Liefert die Zeichenkette des Textelements, das sich an der Position Index im JSON-Objekt json befindet bzw. über den Pfad strPath im JSON-Objekt json erreichbar ist.

Lassen sich bei Json-Funktionen Elemente über deren Pfad ansprechen, so beginnt der Pfad am Root-Element des JSON-Objekts, das der Funkion übergeben wurde.
Der Pfad besteht aus den Punkt-getrennten Elementnamen, die durchlaufen werden müssen, um das Zielelement zu benennen. Soll das n-te Element eines JSONARRAY-Objekts angesprochen werden, so muss nach dem Elementnamen des Arrays ein [ der Index n des gewünschten Arrayelements und ein ] folgen.
Beispiel: "Produktliste.Produkt[1].Type" (Pfad des JSONARRAY-Elements 'Type')
Beispiel: "Produktliste.Produkt[1]" (Pfad des JSON-Elements, das sich an der Position 1 des JSONARRAY-Elements 'Produkt' befindet)
Beispiel: "Produktliste.Produkt" (Pfad des JSONARRAY-Elements 'Produkt')

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 Boolean, Number, isNull;
Boolean = JsonGetBool(json, "Boolean");
//Boolean = true
Number = JsonGetNumber(json, "Number");
//Number = 3.14
String = JsonGetString(json, "String");
isNull = JsonIsNull(json, "String");
//String = "xyz"
//isNull = false
isNull = JsonIsNull(json, "WithoutContent");
//isNull = true
JsonClose(json);
 

Die Json-Funktionen

Siehe auch  JsonGetArray, JsonGetBoolJsonGetNumber, JsonGetObject, JsonGetRoot, JsonGetSize, JsonGetArraySize, JsonGetType