AAdd()

Add a new element to the end of an array.

Syntax

AAdd(<aTarget>, <expValue>) --> Value

Arguments

<aTarget> --> is the array to add a new element to.

<expValue> --> is the value assigned to the new element.

Returns

AAdd() evaluates <expValue> and returns its value. If <expValue> is not specified, AAdd() returns Nil. (No value.)

Description

Once an array has been created, elements can be added using the AAdd() function. AAdd() increases the actual length of the target array by one. The newly created array element is assigned the value specified by <expValue>. AAdd() is used to dynamically grow an array. It is useful for building dynamic lists or queues. AAdd() is similar to ASize() but only adds one element at a time. ASize() can grow or shrink an array to a specified size. AAdd() however, has the advantage that it can assign a value to the new element, while ASize() cannot.

Examples

The following example creates the array aArray1 and adds the value in the variable cName to it.

aArray1 := {}

AAdd(aArray1, cName)

____________________________