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