TJsonArray

Classe

type TJsonArray = class(TJson)

Représente un tableau JSON. Contient zéro ou plusieurs éléments accessibles par index.

Caractéristiques

ElementCount : Integer en lecture et en écriture ;

Définit ou renvoie le nombre d'éléments du tableau.

Elements[Index : Integer] : TJson en lecture-écriture ; par défaut ;

Définit ou récupère l'élément spécifié du tableau. L'index doit être compris entre 0 et ElementCount - 1.

À [Index : Entier] : TJson ;

Permet de récupérer ou de définir un élément d'un tableau si celui-ci est effectivement un TJsonArray et si l'index est valide. Sinon, une exception est levée.

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;

Renvoie l'élément du tableau spécifié si l'index est valide et si le type demandé correspond au contenu.

Méthodes

constructor Create(ElementCount : Integer = 0) ;

Crée une instance TJsonArray.

function AppendArray(ElementCount: Integer): TJsonArray;

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

procédure AppendFalse;

fonction AppendJson(Value: TJson): TJson;

procédure AppendNull;

procédure AppendNumber(Value: Double);

fonction AppendObject: TJsonObject;

procédure AppendString(const Value: WideString);

procédure AppendTrue;

Les méthodes Append augmentent la taille du tableau de 1 et ajoutent le nouvel élément à la fin. Les méthodes AppendArray, AppendJson et AppendObject renvoient des instances des éléments nouvellement créés afin de permettre leur manipulation ultérieure.

procédure Delete(Index : Integer) ;

L'élément du tableau situé à l'index a été supprimé, ce qui a réduit la taille du tableau d'une unité.

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);

Les méthodes Insert augmentent la taille du tableau d'une unité et placent le nouvel élément à l'index indiqué. Les fonctions InsertArray, InsertJson et InsertObject renvoient des instances des éléments nouvellement créés afin de permettre leur manipulation ultérieure.

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);

Les méthodes Set convertissent l'élément situé à l'index indiqué en le type et la valeur spécifiés. Les fonctions SetArray, SetJson et SetObject renvoient des instances des éléments nouvellement modifiés afin de permettre leur manipulation ultérieure.

procédure Swap(Index1, Index2 : Integer) ;

Permute les éléments du tableau spécifié ;

Exemple

jArray = TJsonArray.Create(0) 'Crée un tableau vide
showmessage(jarray.ElementCount) 'Affiche 0

jArray.AppendTrue 'jArray.Elements[0] existe désormais et contient True
showmessage(jArray.ElementCount) 'Affiche 1

jArray.InsertFalse(0) 'jArray.Elements[0] existe désormais et contient False. jArray.Elements[1] contient True
showmessage(jArray.ElementCount) 'Affiche 2

jArray.Delete(0) 'L'ancien élément jArray.Elements[0] a été supprimé. jArray.Elements[0] contient désormais True
showmessage(jArray.ElementCount) 'Affiche 1 |