TJsonArray

Clase

type TJsonArray = class(TJson)

Representa una matriz JSON. Contiene 0 o más elementos a los que se accede mediante un índice.

Características

ElementCount: entero de lectura y escritura;

Establece o devuelve el número de elementos de la matriz.

Elements[Índice: Entero]: TJson lectura-escritura; por defecto;

Establece o recupera el elemento especificado de la matriz. El índice debe estar comprendido entre 0 y ElementCount - 1.

En [Índice: Entero]: TJson;

Permite obtener o establecer un elemento de una matriz si esta es realmente una TJsonArray y el índice es válido. De lo contrario, se produce una excepción.

NullAt[Índice: Entero]: TJsonNull leído;

FalseAt[Índice: Entero]: TJsonFalse leído;

TrueAt[Índice: Entero]: TJsonTrue leído;

ObjectAt[Índice: Entero]: TJsonObject leído;

StringAt[Índice: Entero]: TJsonString leído;

ArrayAt[Índice: Entero]: TJsonArray leído;

NumberAt[Index: Integer]: TJsonNumber read;

Devuelve el elemento de la matriz especificado si el índice es válido y el tipo solicitado coincide con el contenido.

Métodos

constructor Create(ElementCount: Integer = 0);

Crea una instancia de TJsonArray.

función AppendArray(ElementCount: Integer): TJsonArray;

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

procedimiento AppendFalse;

función AppendJson(Value: TJson): TJson;

procedimiento AppendNull;

procedimiento AppendNumber(Value: Double);

función AppendObject: TJsonObject;

procedimiento AppendString(const Value: WideString);

procedimiento AppendTrue;

Los métodos Append aumentan el tamaño de la matriz en 1 y añaden el nuevo elemento al final. AppendArray, AppendJson y AppendObject devuelven instancias de los elementos recién creados para su posterior manipulación.

procedimiento Delete(Índice: entero);

Se ha eliminado el elemento del índice «Index», con lo que el tamaño de la matriz se ha reducido en 1.

función InsertArray(Índice: Integer; NúmeroDeElementos: Integer): TJsonArray;

procedimiento InsertDateTime(Índice: Integer; const Valor: TDateTime; Desplazamiento: Integer = 0);

procedimiento InsertFalse(Índice: Integer);

función InsertJson(Índice: 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);

Los métodos Insert aumentan el tamaño de la matriz en uno, colocando el nuevo elemento en el índice indicado. InsertArray, InsertJson e InsertObject devuelven instancias de los elementos recién creados para su posterior manipulación.

función SetArray(Índice: Integer; NúmeroDeElementos: Integer): TJsonArray;

procedimiento SetDateTime(Índice: Integer; const Valor: TDateTime; Desplazamiento: Integer = 0);

procedimiento SetFalse(Índice: Integer);

función SetJson(Índice: Integer; Valor: TJson): TJson;

procedimiento SetNull(Índice: Integer);

procedimiento SetNumber(Índice: Integer; Value: Double);

function SetObject(Index: Integer): TJsonObject;

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

procedure SetTrue(Index: Integer);

Los métodos Set convierten el elemento del índice indicado al tipo y valor especificados. SetArray, SetJson y SetObject devuelven instancias de los elementos recién modificados para su posterior manipulación.

procedimiento Swap(Índice1, Índice2: entero);

Intercambia los elementos especificados de la matriz;

Ejemplo

jArray = TJsonArray.Create(0) 'Crea una matriz vacía
showmessage(jarray.ElementCount) 'Muestra 0

jArray.AppendTrue 'Ahora existe jArray.Elements[0] y contiene True
showmessage(jArray.ElementCount) 'Muestra 1

jArray.InsertFalse(0) 'Ahora existe jArray.Elements[0] y contiene False. jArray.Elements[1] contiene True
showmessage(jArray.ElementCount) 'Muestra 2

jArray.Delete(0) 'Se ha eliminado el antiguo elemento jArray.Elements[0]. jArray.Elements[0] ahora contiene True
showmessage(jArray.ElementCount) 'Muestra 1 |