TJsonArray

Klasse

Typ TJsonArray = Klasse(TJson)

Stellt ein JSON-Array dar. Enthält 0 oder mehr Elemente, auf die über einen Index zugegriffen wird.

Eigenschaften

ElementCount: Integer read write;

Die Anzahl der Elemente im Array festlegen bzw. zurückgeben.

Elements[Index: Integer]: TJson read write; default;

Das angegebene Array-Element setzen bzw. abrufen. Der Index muss zwischen 0 und ElementCount - 1 liegen.

Bei [Index: Ganzzahl]: TJson;

Ermöglicht das Abrufen bzw. Setzen eines Array-Elements, sofern es sich tatsächlich um ein TJsonArray handelt und der Index gültig ist. Andernfalls wird eine Ausnahme ausgelöst.

NullAt[Index: Integer]: TJsonNull read;

FalseAt[Index: Integer]: TJsonFalse read;

TrueAt[Index: Integer]: TJsonTrue read;

ObjectAt[Index: Integer]: TJsonObject read;

StringAt[Index: Integer]: TJsonString read;

ArrayAt[Index: Integer]: TJsonArray read;

NumberAt[Index: Integer]: TJsonNumber read;

Gibt das angegebene Array-Element zurück, sofern der Index gültig ist und der angeforderte Typ mit dem Inhalt übereinstimmt.

Methoden

Konstruktor Create(ElementCount: Integer = 0);

Erstellt eine TJsonArray-Instanz.

function AppendArray(ElementCount: Integer): TJsonArray;

procedure AppendDateTime(const Value: TDateTime; Offset: Integer = 0);

procedure AppendFalse;

function AppendJson(Value: TJson): TJson;

procedure AppendNull;

procedure AppendNumber(Value: Double);

function AppendObject: TJsonObject;

procedure AppendString(const Value: WideString);

procedure AppendTrue;

Die Append-Methoden vergrößern das Array um 1 und fügen das neue Element am Ende ein. Die Funktionen AppendArray, AppendJson und AppendObject geben Instanzen der neu erstellten Elemente zurück, die weiter bearbeitet werden können.

Prozedur Delete(Index: Integer);

Das Array-Element am Index wurde entfernt, wodurch sich die Größe des Arrays um 1 verringert hat.

function InsertArray(Index: Integer; ElementCount: Integer): TJsonArray;

procedure InsertDateTime(Index: Integer; const Value: TDateTime; Offset: Integer = 0);

procedure InsertFalse(Index: Integer);

function InsertJson(Index: Integer; Value: TJson): TJson;

procedure InsertNull(Index: Integer);

procedure InsertNumber(Index: Integer; Value: Double);

function InsertObject(Index: Integer): TJsonObject;

procedure InsertString(Index: Integer; const Value: WideString);

procedure InsertTrue(Index: Integer);

Die Insert-Methoden vergrößern das Array um einen Platz und fügen das neue Element an der angegebenen Position ein. InsertArray, InsertJson und InsertObject geben Instanzen der neu erstellten Elemente zurück, die weiter bearbeitet werden können.

function SetArray(Index: Integer; ElementCount: Integer): TJsonArray;

procedure SetDateTime(Index: Integer; const Value: TDateTime; Offset: Integer = 0);

procedure SetFalse(Index: Integer);

function SetJson(Index: Integer; Value: TJson): TJson;

procedure SetNull(Index: Integer);

procedure SetNumber(Index: Integer; Value: Double);

function SetObject(Index: Integer): TJsonObject;

procedure SetString(Index: Integer; const Value: WideString);

procedure SetTrue(Index: Integer);

Die Set-Methoden wandeln das Element am angegebenen Index in den angegebenen Typ und Wert um. Die Funktionen SetArray, SetJson und SetObject geben Instanzen der neu geänderten Elemente zur weiteren Bearbeitung zurück.

Prozedur Swap(Index1, Index2: Integer);

Tauscht die angegebenen Array-Elemente aus;

Beispiel

jArray = TJsonArray.Create(0) 'Erstellt ein leeres Array
showmessage(jarray.ElementCount) 'Zeigt 0 an

jArray.AppendTrue 'jArray.Elements[0] existiert nun und enthält True
showmessage(jArray.ElementCount) 'Zeigt 1 an

jArray.InsertFalse(0) 'jArray.Elements[0] existiert nun und enthält False. jArray.Elements[1] enthält „True“
showmessage(jArray.ElementCount) 'Zeigt „2“ an

jArray.Delete(0) 'Das alte Element jArray.Elements[0] wurde gelöscht. jArray.Elements[0] enthält nun „True“
showmessage(jArray.ElementCount) 'Zeigt 1 an |