ADEL()
 Elimina um elemento de vetor
------------------------------------------------------------------------------

 Sintaxe

     ADEL(<aDestino>, <nPosiçao>) --> aDestino

 Argumentos

     <aDestino> é o vetor que contém um elemento a ser eliminado.

     <nPosiçao> é a posiçao do elemento de vetor que será eliminado.

 Retorno

     ADEL() retorna uma referência ao vetor destino, <aDestino>.

 Descriçao

     ADEL() é uma funçao de tratamento de vetor que elimina um elemento de
     um vetor.  O conteúdo do elemento de vetor especificado é perdido, e
     todos os elementos a partir daquela posiçao até o final do elemento
     sobem uma posiçao.  O último elemento no vetor torna-se NIL.

     -----------------------------------------------------------------------
     . Aviso

     Em Clipper, vetores multi-dimensionais sao implementados através do
     aninhamento de vetores dentro de outros vetores.  Caso o vetor <aFonte>
     seja um vetor multi-dimensional, ADEL() eliminará todo o sub-vetor
     especificado por <nPosiçao>, forçando <aFonte> a nao mais ter dimensoes
     regulares.
     -----------------------------------------------------------------------

 Exemplos

     Este exemplo cria um vetor constante de três elementos, e depois
     elimina o segundo elemento.  O terceiro elemento sobe uma posiçao, e ao
     novo terceiro elemento é atribuido NIL:

     LOCAL aArray
     aArray := { 1, 2, 3 }          // Resulta: aArray e agora { 1, 2, 3 }
     ADEL(aArray, 2)                // Resulta: aArray e agora { 1, 3, NIL }

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: ACOPY() AFILL() AINS()