Array append
Arrays and ranges
Generic
Array append
Array
Array
Element
Description
Appends an element to an array in place and returns the updated array. Has execution pins (not pure).
When to use
Use Array append when you need to build up an array element by element — for example, collecting results inside a loop. Wire an existing array (from a local variable or a previous node) into the Array input and the new value into Element. The node mutates the array in place and outputs the updated reference.
Pins
Input pins
| Pin | Type | Default | Notes |
|---|---|---|---|
| Array | generic[] | — | The array to append to. The element type resolves at design-time from the connected source. |
| Element | generic | — | The element to append. Must match the array's element type. |
Output pins
| Pin | Type | Notes |
|---|---|---|
| Array | generic[] | The same array after the element has been appended. |
Execution pins
| Pin | Direction |
|---|---|
| In | Input |
| Out | Output |
Example
Inside a For each loop, append each processed item to an accumulator array stored in a local variable. Wire the local variable read into Array, the loop body’s transformed value into Element, then wire the output Array back into a local variable set to persist the change for the next iteration.