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:
All devices (only within an optimized FPGA VI)
Web Server: Supported in VIs that run in a web application