aDestinoArrayRequired
Array that receives the new last element and is resized.
FUNCTIONPublished
AAdd
AAdd( <aDestino>, <xExpressao> ) → xExpressaoAppends one element to an array and increases its size by one position.
Overview
AAdd() appends the value of any valid AdvPL expression to an array and returns that value. It is useful for lists, queues and matrix rows whose size is not known in advance.
Syntax
AAdd( <aDestino>, <xExpressao> ) → xExpressaoParameters
xExpressaoQualquerRequired
Value assigned to the new position; it may also be another array.
Return value
Returns the value supplied in xExpression, not necessarily the destination array.
Appending values to a vector
User Function ExAAddNames()
Local aNames := {}
AAdd(aNames, "Alice")
AAdd(aNames, "Bruno")
AAdd(aNames, "Carla")
MsgInfo(aNames[3], "Third name")
ReturnExpected result
The array contains three values and position 3 contains “Carla”.
Building a matrix
// See the Portuguese example; localize only user-facing text.Expected result
Each main-array element is a row containing a name and an age.
Return value and array reference
User Function ExAAddReferencia()
Local aDestino := {}
Local aLinha := {"Produto", 10}
Local xRetorno := AAdd(aDestino, aLinha)
aLinha[2] := 20
ConOut(xRetorno[2]) // 20
ConOut(aDestino[1][2]) // 20
ReturnExpected result
The return value is the appended row, and later source-array changes are visible through the stored reference.
- Use Len() to read the new size.
- An appended array is stored by reference.
- Use AClone() when an independent nested copy is required.
- Use AIns() for an existing position and ASize() for direct resizing.
- AdvPL arrays are one-based.
- Do not assign aDestination := AAdd(...), because the function returns the appended value.
- Keep matrix rows structurally consistent.
- Avoid unbounded growth in loops.
- Remember that the received array is modified.