Deletes a specified element or subarray of an array.
This node returns both the edited array and the deleted element or subarray.
array
The array from which you want to delete elements, rows, columns, pages, and so on. This input is an n-dimension array of any type.
length
Number of elements, rows, columns, or pages to delete.
Default: 1
index
The location of the element or subarray to delete from the array.
If index is unwired, this node deletes from the end of the array.
Behavior of index inputs for Multidimensional Arrays
When you wire an array to this node, the node resizes automatically to display index inputs for each dimension in the array. This node reduces the array in one dimension only, therefore, you can wire only one index input. For example, to delete a row in a 2D array, wire only the row index. To delete a column, wire only the column index.
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 |
Default: The index of the last element in the array.
array with subset deleted
The array returned with the deleted elements, rows, columns, or pages.
deleted portion
The deleted element or array.
Diagram |
array |
deleted portion |
Comments |
|
1D array |
A scalar containing the 2nd element from array |
To delete a single element from a 1D array, leave length unwired, and specify the element to delete in index. |
|
1D array |
1D array containing only the 4th element from array |
To delete one or more elements from a 1D array, specify the number of elements to delete in length, and the index at which to begin the deletion in index. |
|
3D array of dimensions 10x4x6 |
3D array of dimensions 2x4x6 containing the last 2 pages from array |
The outer dimension size of deleted portion is the value of length, and the inner dimension size(s) match that of array. |
|
2D array of dimensions 8x5 |
1D array containing all elements from row 3 of array |
If you do not wire a value to length, deleted portion is an array of one less dimension than array containing the portion of the array deleted from array. |
|
2D array of dimensions 6x3 |
2D array of dimensions 6x2 |
If you wire a value to length and a negative value to the index, deleted portion is an array with an outer dimension size of the value of length subtracted by the absolute value of the index. |
Where This Node Can Run:
Desktop OS: Windows
FPGA: DAQExpress does not support FPGA devices
Web Server: Supported in VIs that run in a web application