要素または部分配列をn次元配列の指標で指定した位置に挿入します。

この関数に配列を配線すると、関数は自動的にサイズ調整して、配列の各次元の指標入力を表示します。指標入力に何も配線されていない場合、関数は新規要素または部分配列をn次元配列の末尾に追加します。指標入力が配列サイズより大きい場合、関数は入力配列に何も挿入しません。


icon

入力/出力

  • c1ddbl.png 配列 —

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

  • ci32.png 指標 —

    指標 0..nは、要素、行、列、または、ページなどを挿入する配列内のポイントを指定します。指標入力のみを配線できます。

    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 出力配列 —

    出力配列は、挿入した要素、行、列、またはページを含む配列です。

    • メモ 新規の要素または配列のベースデータタイプは、入力配列と同じタイプでなければなりません。たとえば、入力配列にブール制御器リファレンスに含まれる場合、新規要素はブール制御器リファレンスである必要があります。より一般的な要素を配列に挿入する場合に入力配列を作成するには、「より一般的なクラスに変換」関数を使用します。

    この関数は、1つの次元のみで配列をサイズ調整します。したがって、1つの指標入力のみしか配線できません。配線する指標によって、挿入できる次元が決定します。たとえば、行を挿入するには行指標を配線し、列を挿入するには列指標を配線します。

    nまたはn-1次配列に配線する配列は、n次元配列に配線した配列よりも小さい次元でなくてはなりません。たとえば、2D配列に単一の要素を挿入したり、3次元配列に単一の行 (1D配列) を挿入することはできません。ただし、単一の行の2D配列は3次元配列に挿入できます。LabVIEWは、必要に応じて出力結果の配列をパッドします。

    FPGAモジュールの詳細

    以下の説明は、このオブジェクトをFPGA VIで使用する場合に適用されます。

    メモ 以下の詳細は、LabVIEW FPGAモジュールのバージョンごとに変更される場合があります。
    シングルサイクルタイミングループ サポートあり
    Usage 指標入力が要素を挿入する配列の範囲を超えていると、入力配列に何も挿入されません。LabVIEW FPGAモジュールは、コンパイル時に固定サイズに決定される1次元配列のみをサポートしています。LabVIEWが出力配列のサイズを決定できるように、指標入力は定数である必要があります。定数値をこの関数に直接配線するか、定数の畳み込みを介した値の伝播に依存することができます。
    タイミング この関数は、内部レジスタを持たないため実行クロックサイクルは必要ありません。
    リソース この関数は単なる配線操作であるため、FPGAリソースを必要としません。