Returns the element or sub-array of n-dimension array at index. When you wire an array to this function, the function resizes automatically to display index inputs for each dimension in the array you wire to n-dimension array. You also can add additional input terminals by resizing the function. The connector pane displays the default data types for this polymorphic function. Details
![]() |
n-dimension array can be an n-dimensional array of any type. If n-dimension array is an empty array, the value of element or sub-array is the default of the data type of array (zero for numbers, FALSE for Boolean controls, and empty for string). |
![]() |
index 0 must be numeric.
The number of index inputs matches the number of dimensions in n-dimension array.
If the index is out of range (<0 or |
![]() |
element or subarray has the same type as the elements of n-dimension array. In addition to extracting an element of the array, you can slice out a higher-dimensional component by leaving one or more of the index terminals unwired. For example, pull column 1 of a 2D array by specifying 1 in the column index and leaving the row index unwired. |
You can disable indexing along a dimension by leaving the corresponding index input unwired, unless you are indexing a 1D array. By default, the first dimension has indexing enabled, with the others disabled. If disabled, the input terminal is an outlined black rectangle. If enabled, it is filled. You can wire a constant or control to the index inputs that you want enabled.
For example, if you want to index a row in a 2D array, the first index input is enabled and the second index input is disabled. If you want to index that same 2D array also by column, you can resize the function to show another set of input terminals. This next set of inputs has its own corresponding sub-array output. By default, if you do not wire any index input terminals, the first sub-array indexes row 0, the second sub-array indexes row 1, and so on.