在n维数组中索引指定的位置插入元素或子数组。

连线数组至该函数时，函数可自动调整大小以显示数组各个维度的索引。如未连线任何索引输入，该函数可添加新的元素或字数组至n维数组之后。如索引大于数组大小，函数不对输入数组进行插入。


icon

输入/输出

  • c1ddbl.png 数组 —

    n维数组是要插入元素、行、列或页的数组。输入可以是任意类型的n维数组。

  • ci32.png 索引 —

    索引0..n-1指定数组中要插入元素、行、列或页的点。只能连线一个索引输入端。

    For example, to insert a 1D array as the fourth row of a 2D array, wire 3 to the first index input, and the second index input becomes disabled. To insert the array as the fourth column of the 2D array, wire 3 to the second index input, and the first index input becomes disabled.
  • cdbl.png 新元素/子数组 —

    n或n-1维数组是要插入n维数组的元素、行、列或页。

  • ipoly.png 输出数组 —

    输出数组函数返回的数组中已经对元素、行、列或页进行了替换。

    • 注： 新元素或数组的基本数据类型必须和输入数组的类型一致。例如，在输入数组包含布尔控件引用，则新元素必须为布尔控件引用。如需在数组中插入更通用的元素，可使用转换为通用的类函数创建输入数组。

    该函数只在一个维度上调整数组的大小。因此，只能连线一个索引输入。连线的索引确定数组中可以插入元素的维度。例如，要插入行，连线行索引；要插入列，连线列索引。

    连线至n或n-1维数组的数组的维数必须与n维数组的维数相等或小一个维度。例如，不能在二维数组中插入单个元素，也不能在三维数组中插入一行（视为一维数组）。可以在三维数组中插入只有一行的二维数组。如有需要，LabVIEW可对结果数组进行填充。

    FPGA模块详细信息

    下列信息适用于在FPGA VI中使用上述对象。

    注： 下列信息可能因LabVIEW FPGA模块的不同版本而有所不同。
    单周期定时循环 支持。
    Usage 如果索引输入端的值超出了待插入元素的数组的范围，函数不会插入任何值至输入端数组。LabVIEW FPGA模块仅支持编译时可转换为单个大小的一维数组。索引输入端必须为常量，LabVIEW才能判定输出数组的大小。下列两种方式可选择其一：直接连线常量值至函数,或依赖常量折叠传输值。
    定时 函数不需要用于执行的时钟周期，因为函数不包含内部寄存器。
    资源 函数不占用FPGA资源，因为仅执行连线操作。