Insert into Array
- Updated2023-02-17
- 2 minute(s) read
Insert into Array
Inserts an element or subarray into an array at the index you specify.
Inputs/Outputs
array
Inserts an element or subarray into an array at the index you specify.
index
The location in the array where you want to insert the element, row, column, page, and so on. This node automatically provides an index input for each dimension of the array. You can wire only one index input.
If index is larger than the array size, the node does not insert anything into the input array.
Default value: new element or subarray appends to the end of array.
Relationship between index Inputs and array Dimensions
For multidimensional arrays, index inputs correspond to row-major order. Thus, the first index corresponds last dimension of the array input, and the last index corresponds to the first dimension of the array input. The following table shows the relationship between four index inputs and the dimensions of a 4D array input.
| index Order | Corresponding Dimension in array Input | index Name |
|---|---|---|
| 1 | 4th | volume index |
| 2 | 3rd | page index |
| 3 | 2nd | row index |
| 4 | 1st | column index |
new element or subarray
The element or array that replaces an element, row, column, or page in the array specified in array.
This input changes to new element/waveform subset when you wire a waveform to array.
output array
The array with the inserted element(s).