AADD()
Agrega dinámicamente un nuevo elemento al final de un array
- Syntax
-
- AADD(<aDestino>, <xValor>) --> Valor
- Arguments
-
- <aDestino> es el array al cual se agrega un nuevo elemento.
- <xValor> es el valor asignado al nuevo elemento.
- Returns
-
- AADD() evalúa <xValor> y retorna su valor. Si <xValor> no esta especificado, AADD() retorna NIL.
- Description
-
- AADD() es una función que dinámicamente incrementa la longitud actual del array destino en un elemento y asigna el valor <xValor> al recién creado elemento del array. <xValor> puede ser un puntero de referencia a otro array, el cual puede ser asignado a la posicion subindice.
- Es útil para construir listas dinámicas o colas (queues). Cada vez que se ejecuta un comando @...GET, el sistema usa AADD() para agregar un nuevo elemento al final del array GetList, y entonces asignar un nuevo objeto Get al nuevo elemento.
Examples
* Este ejemplo muestra el efecto de múltiples llamadas de la función
AADD() a un array, donde va agrgando un nuevo elemento cada vez.
LOCAL aArray := {}
FOR x:= 1 to 10
AADD( aArray, x)
NEXT
* Este ejemplo crea un array multidemensional
LOCAL aArray := {} // Resultado: aArray es un array vacío
AADD( aArray, {10, 10122734 }) // Resultado: aArray es {10, 10122734}
AADD( aArray, {11, 13173645 }) // Resultado: aArray es
{ { 10, 10122734 }, { 11, 13173645 } }
- Status
- Ready
- Compliance
-
- Esta función es totalmente compatible con CA-Clipper.
- Platforms
-
- Todas las plataformas
- Files
-
- El código fuente está en arrays.c La librería asociada es vm
- See Also