AFILL ( )
Rellena una matriz con un valor especificado
Sintaxis
AFILL(, ,
[], []) –> aDestino
Argumentos
es la matriz que se va a rellenar.
es el valor que se va a colocar en cada elemento de la matriz. Puede ser una expresión de cualquier tipo válido.
es la posición del primer elemento que se va a llenar. Si se omite este argumento, el valor por defecto es uno.
es el número de elementos que se van a llenar comenzando por . 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 .
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 a cada elemento de matriz dentro del rango especificado.
¡Advertencia! AFILL() no puede utilizarse para llenar matrices multidimensionales. DPXBASE 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 DPXBASE.CH.