Histórico da 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 }