APPEND TO ARRAY
APPEND TO ARRAY ( array : Array ; valor : Expression )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| array | Array | → | Array ao qual o elemento será anexado |
| valor | Expression | → | Valor a acrescentar |
Histórico
| Versão | Alterações |
|---|---|
| 2004 | Criado por |
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)
Ver também
DELETE FROM ARRAY
INSERT IN ARRAY
Propriedades
| Número do comando | 911 |
| Thread-seguro | yes |