从索引中指定的位置开始替换数组中的某个元素或子数组。

连线数组至该函数时，函数可自动调整大小，显示连线数组各个维度的索引。连线板显示该多态函数的默认数据类型。


icon

输入/输出

  • c1ddbl.png 数组 —

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

  • ci32.png 索引 —

    索引0..n-1指定数组中要替换的元素、行、列或页。如未连线该输入端，新元素/子数组输入的维数可确定n维数组的元素数，从元素0开始，函数进行替换。如果指定索引但未连接以下索引，则此函数将从指定的最后一个索引继续。

    例如，如未连线该输入端并且n维数组包含3个元素，新元素/子数组包含2个元素，该函数只替换n维数组的前两个元素（0和1）。如指定1作为第一个索引，但未连线其他索引并且n维数组包含3个元素，新元素/子数组包含2个元素，该函数只替换n维数组的第二和第三个元素（1和2）。
  • cdbl.png 新元素/子数组 —

    新元素/子数组是数组或元素，用于替换由n维数组指定的数组中的元素、行、列或页。

    备注 新元素或子数组的基本数据类型必须与输入数组一致。
  • i1duvoid.png 输出数组 —

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

    • 调整该函数的大小，可一次替换多个元素或数组子集。替换数组子集不影响原始的输入数组。该函数可截取任何行、列或页大小超出输入数组的子数组。如索引为负，或超出n维数组的相应维度，函数无效。

    FPGA 模块详细信息

    下列详细信息适用于在 FPGA VI 中使用此对象。

    备注 下列详细信息可能会随着 LabVIEW FPGA 模块的每个版本而变化。
    单周期定时循环 支持。
    用途 LabVIEW FPGA模块仅支持编译时可转换为单个大小的一维数组。可使用常量或非常量输入。
    定时 函数在一个时钟周期内执行。但当直接连接常量至函数的索引输入端时，函数将在编译时选择索引。此时函数不需要用于执行的时钟周期。
    资源 索引不是常量的情况下，函数消耗的FPGA资源与数组和新元素/子数组的大小成比例。索引为常量的情况下，函数不占用FPGA资源。
    注释 对于大型数组，“替换数组子集”函数可能无法在一个时钟周期内完成，从而导致编译时间错误。

    范例

    请参考随 LabVIEW 一起提供的以下示例文件。

    • labview\examples\Arrays\Replace Array Elements.vi