指標で指定した配列内の要素、または配列を別の要素に置換します。

この関数に配列を配線すると、この関数は自動的にサイズ調整を行い、配線した配列の各次元数に対して指標入力を表示します。コネクタペーンには、この多態性関数のデフォルトのデータタイプが表示されます。


icon

入力/出力

  • c1ddbl.png 配列 —

    n次元配列は、置換する要素、行、列、またはページを含む配列です。任意のタイプのn次元配列が可能です。

  • ci32.png 指標 —

    指標 0..nは、配列で置き換える要素、行、列、またはページを指定します。この入力を配線しない場合、新規要素/部分配列入力の次元は、この関数が置換する要素0で始まるn次元配列の要素数を決定します。以下の指標を配線せずに指標を指定した場合、この関数は、最後に指定された指標から続行します。

    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モジュールは、コンパイル時に固定サイズに決定される1次元配列のみをサポートしています。定数と定数以外の入力を使用できます。
    タイミング この関数は1つのクロックサイクル内で実行されます。指標入力に定数を直接配線すると、コンパイル時に選択が発生し関数でクロックサイクルが必要なくなります。
    リソース 指標が定数でない場合、この関数は配列のサイズおよび新規要素/部分配列のサイズに比例する量のFPGAリソースを消費します。指標が定数の場合、この関数はFPGAリソースを消費しません。
    メモ 大規模な配列では、「部分配列置換」関数が1クロックサイクルで実行できなくなり、コンパイルエラーが発生する可能性があります。

    サンプルプログラム

    LabVIEWに含まれている以下のサンプルファイルを参照してください。

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