4D Doc Center : APPEND TO ARRAY

4D v14.3

APPEND TO ARRAY


APPEND TO ARRAY ( array ; valor )

Parâmetro	Tipo	Descrição
array	Array	Array ao qual o elemento será anexado
valor	Expression	Valor a acrescentar

Descrição

O comando APPEND TO ARRAY adiciona um novo elemento ao fim do array e atribui valor ao elemento. Em modo interpretado, se array não existe, o comando o cria com com respeito ao tipo de valor.

Esse comando trabalha com todos os tipos de array: alfanumérico, numérico, booleano, data, apontador e imagem.

O tipo de valor deve combinar com o tipo de array, caso contrário, será gerado um erro de sintaxe 54 "Os tipos de argumento são incompatíveis". Os seguintes valores, contudo, serão aceitos:
• um array alfanumérico (Texto ou Alfa) aceita qualquer valor de tipo alfanumérico ou texto.
• um array de numérico (Inteiro, Inteiro largo ou Real) aceita qualquer valor de tipo Inteiro, Inteiro Largo, Real ou Hora.

Exemplo

O seguinte código:

 INSERT IN ARRAY($meuarray;Size of array($meuarray)+1)

 $meuarray{Size of array($meuarray)}:=$meuvalor

... pode ser substituído por:

APPEND TO ARRAY($meuarray;$meuvalor)