AADD()

Dynamically add an element to an array

Syntax

      AADD(<aArray>[, <xValue>]) --> Value

Arguments

<aArray> The name of an array

<xValue> Element to add to array <aArray>

Returns

<Value> if specified <xValue>, <xValue> will return , otherwise this function returns a NIL value.

Description

This function dynamically increases the length of the array named <aArray> by one element and stores the value of <xValue> to that newly created element.

<xValue> may be an array reference pointer, which in turn may be stored to an array’s subscript position.

Examples

      LOCAL aArray := {}
      LOCAL x
      AAdd( aArray, 10 )
      FOR x := 1 TO 10
         AAdd( aArray, x )
      NEXT
      // Result is: { 10, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }

Compliance

Clipper

Files

Library is vm

Seealso

AINS(), ASIZE()