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

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


icon

输入/输出

  • c1ddbl.png 数组 —

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

  • ci32.png 索引 —

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

    For example, if you do not wire this input and n维数组 consists of three elements, and 新元素/子数组 consists of two elements, this function replaces only the first two elements (0 and 1) ofn维数组. If you specify 1 for the first index without wiring other indexes and n维数组 consists of three elements, and 新元素/子数组 consists of two elements, this function replaces only the second and the third element (1 and 2) of n维数组.
  • cdbl.png 新元素/子数组 —

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

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

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

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

    FPGA模块详细信息

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

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

    范例

    请参考LabVIEW附带的下列范例文件。

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