AFILL()

Rellena un array con un valor especificado

Syntax

AFILL( <aDestino>, <xValor>, [<nInicio>], [<nContador>] ) --> aDestino

Arguments

<aDestino> es el nombre del array a rellenar

<xValor> es la expresión con la que será rellenado <aDestino>

<nInicio> es la posición de comienzo, subíndice del array

<nContador> es el número de elementos que se van a rellenar

Returns

AFILL() retorna una referencia al array destino, <aDestino>

Description

Esta función rellena cada elemento del array llamado <aDestino> con el valor <xValor>. Si es especificado, <nInicio> marca el elemento de inicio para continuar rellenando por <nContador> posiciones. Si no es especificado, el valor de <nInicio> será 1, y el valor de <nContador> será el valor de LEN(<aDestino>); y todos las posiciones del array <aDestino> serán llenadas con la expresión de <xValor>.

Advertencia !: Esta función sólo trabaja en una sola dimensión de <aDestino>. Si hay punteros de referencia a otros arrays dentro de un subíndice de <aDestino> estos valores se perderán, porque esta función los sobreescribe con los nuevos valores.
Examples
      *  El siguiente ejemplo crea un array con valores asignados, luego
         lo rellena con el valor cinco.

         LOCAL aTest := { NIL, 0, 1, 2 }
         Afill( aTest, 5)               // Resultado aTest es { 5, 5, 5, 5 }
Status

Ready

Compliance

Esta función es totalmente compatible con CA-Clipper.

Files

El código fuente está en arrays.c La librería asociada es vm

See Also