AFILL()
 Rellena una matriz con un valor especificado
------------------------------------------------------------------------------
 Sintaxis

     AFILL(<aDestino>, <expValor>,
        [<nInicio>], [<nPosiciones>]) --> aDestino

 Argumentos

     <aDestino> es la matriz que se va a rellenar.

     <expValor> es el valor que se va a colocar en cada elemento de la
     matriz. Puede ser una expresión de cualquier tipo de datos válido.

     <nInicio> es la posición del primer elemento que se va a llenar. Si
     se omite este argumento, el valor por defecto es uno.

     <nPosiciones> es el número de elementos que se van a llenar
     comenzando por <nInicio>. Si se omite este argumento, los elementos
     se rellenan desde el elemento inicial hasta el final de la matriz.

 Devuelve

     AFILL() devuelve una referencia a <aDestino>.

 Descripción

     AFILL() es una función de matrices que rellena la matriz especificada
     con un valor de cualquier tipo de datos (incluyendo matrices, bloques
     de código o valores NIL), asignando <expValor> a cada elemento de
     matriz dentro del rango especificado.

     ¡Advertencia! AFILL() no puede utilizarse para llenar matrices
     multidimensionales. CA-Clipper crea las matrices las multidimensionales
     anidando unas matrices dentro de otras. La utilización de AFILL() con
     una matriz multidimensional sobreescribe las submatrices que se
     utilizan para las otras dimensiones de la matriz.

 Ejemplos

      El ejemplo siguiente crea una matriz de tres elementos, la
        rellena con el valor lógico (.F.) y, finalmente, a los elementos de
        las posiciones dos y tres les asigna el valor verdadero (.T.):

        LOCAL aLogico[3]
        //Resultado: aLogico es { NIL, NIL, NIL }

        AFILL(aLogico, .F.)
        //Resultado: aLogico es { .F., .F., .F. }

        AFILL(aLogico, .T., 2, 2)
        //Resultado: aLogico es { .F., .T., .T. }

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: AADD() AEVAL() DBSTRUCT() DIRECTORY()