AINS()

Sintaxis

AINS( <array>, <expresión numérica> )

Propósito

Incluye un nuevo elemento, con contenido indefinido (NIL), en una posición específica del array.

Argumentos

< array >

Define el nombre del array en el cual se incluirá el nuevo elemento.

< expresión numérica >

Define la posición en la cual se incluirá el nuevo elemento en el array.

Utilización

El nuevo elemento incluido en el array en la posición especificada, pasa a tener el contenido indefinido (NIL). Por lo tanto, este debe definirse después de la inclusión. Todos los otros elementos del array, a partir de la posición en la cual el nuevo elemento se incluyó hasta el final del array, se desplazan una posición a más. El último elemento se descarta y se pierde.

Sugerencias

La función AINS() es equivalente a la ejecución de las siguientes instrucciones:

LOCAL aVetor[20]

LOCAL nPos            := 7

LOCAL nCont           := 0

nTam := LEN(aVetor)          // nTam será igual a 20

FOR nCont := nTam TO (nPos – 1) STEP -1

          aVetor[nCont] := aVetor[nCont-1]

NEXT

aVetor[nPos] := NIL          // Pasa a ser indefinido y el elemento 20 se pierde.

Ejemplos

Este ejemplo muestra el efecto de la utilización de la función AINS() en un array:

LOCAL aArray

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

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