Histórico da Página

Sintaxe

ADEL( <array>, <expressão numérica> )

Propósito

A função ADEL() elimina um elemento de um array.

Argumentos

< array >

Define o nome do array que terá um elemento eliminado

< expressão numérica >

Define a posição (número) do elemento que será eliminado.

Utilização

A função ADEL() deve ser utilizada quando se deseja eliminar um elemento qualquer de um array, deslocando todos os outros uma posição a menos.

O conteúdo do elemento é perdido e todos os elementos a partir daquela posição até o final do array sobem uma posição. O conteúdo do último elemento no array torna-se NIL.

Dicas

No AdvPL, os arrays multidimensionais são implementados como arrays contendo outros subarrays. Se o array especificado for multidimensional, a função ADEL() poderá eliminar um subarray inteiro, especificado pela posição definida na expressão numérica, fazendo com que o array especificado deixe de possuir dimensões normais ou proporcionais.

Exemplos

Este exemplo cria um vetor constante de três elementos, e depois elimina o segundo elemento. Neste caso, o terceiro elemento sobe uma posição, e ao novo terceiro elemento é atribuído o valor NIL:

LOCAL aArray

aArray := { 1, 2, 3 }            // Resulta: { 1, 2, 3 }

ADEL(aArray, 2)                // Resulta: { 1, 3, NIL }