Incluir Página | ||||
---|---|---|---|---|
|
Sintaxe
AINS( <array>, <expressão numérica> )
Propósito
Insere um novo elemento, com conteúdo indefinido (NIL), em uma posição específica do array.
Argumentos
< array >
Define o nome do array no qual será inserido o novo elemento.
< expressão numérica >
Define a posição na qual o novo elemento será inserido no array.
Utilização
O novo elemento inserido no array, na posição especificada, passa a ter o conteúdo indefinido (NIL). Portanto, ele deve ser definido após a inserção. Todos os outros elementos do array, a partir da posição na qual o novo elemento foi inserido até o final do array, são deslocados uma posição a mais. O último elemento é descartado e perdido.
Dicas
A função AINS() é equivalente à execução das seguintes instruções:
LOCAL aVetor[20]
LOCAL nPos := 7
LOCAL nCont := 0
nTam := LEN(aVetor) // nTam será igual à 20
FOR nCont := nTam TO (nPos – 1) STEP -1
aVetor[nCont] := aVetor[nCont-1]
NEXT
aVetor[nPos] := NIL // Passa a ser indefinido e o elemento 20 é perdido.
Exemplos
Este exemplo demonstra o efeito da utilização da função AINS() em um array:
LOCAL aArray
aArray := { 1, 2, 3 } // Resulta: { 1, 2, 3 }
AINS(aArray, 2) // Resulta: { 1, NIL, 2 }