Table Of Contents

Delete from Array (G Dataflow)

Version:
    Last Modified: December 12, 2016

    Deletes a specified element or subarray of an array.

    This node returns both the edited array and the deleted element or subarray.

    connector_pane_image
    datatype_icon

    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.

    datatype_icon

    length

    Number of elements, rows, columns, or pages to delete.

    Default: 1

    datatype_icon

    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.

    datatype_icon

    array with subset deleted

    The array returned with the deleted elements, rows, columns, or pages.

    datatype_icon

    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


    Recently Viewed Topics