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