Elem_OfArray3D

配列の要素数取得

配列の1次元、2次元、3次元毎の要素数を出力します。

パラメータ

入力

Array3D (ANY_IN_UNITS_OF_WORDS): 要素数を取得する入力変数(1、2、3次元配列)を指定します。

出力

NrOfElem1 (INT, DINT, UINT, UDINT): 1次元の要素数が出力されます。
NrOfElem2 (INT, DINT, UINT, UDINT): 2次元の要素数が出力されます。
NrOfElem3 (INT, DINT, UINT, UDINT): 3次元の要素数が出力されます。

解説

Array3Dが1次元配列の場合:

入力Array3Dの配列要素数が、出力NrOfElem1に出力されます。
出力NrOfElem2には、値"1"が出力されます。
出力NrOfElem3には、値"1"が出力されます。

Array3Dが2次元配列の場合:

入力Array3Dの配列から、1次元の要素数が出力NrOfElem1に、2次元の要素数が出力NrOfElem2に出力されます。
出力NrOfElem3には、値"1"が出力されます。

Array3Dが3次元配列の場合:

入力Array3Dの1次元の要素数はNrOfElem1に、2次元の要素数はNrOfElem2に、3次元の要素数はNrOfElem3に、それぞれ出力されます。

このように、様々な長さの配列を処理するファンクションやファンクションブロックを記述することができます。(GetPointer, AreaOffs_ToVar,Var_ToAreaOffsの各ファンクションと組み合わせて使用することもできます。)

注記

要素数の積NrOfElem1 * NrOfElem2 * NrOfElem3は、常に配列の要素総数に等しくなります。

例

POUヘッダ

POUヘッダには、このプログラムで使用するすべての入力変数と出力変数を宣言します。 POUヘッダは全プログラム言語で使用できます。

	VAR
		ArrayOfInt: ARRAY [2..15,3..20,4..25] OF INT:=[5544(0)];
		NumberOfDim1: INT:=0;
		NumberOfDim2: INT:=0;
		NumberOfDim3: INT:=0;
	END_VAR

POUボディ

この例は、EN/ENOがない場合を示します。ファンクションElem_OfArray3Dは毎スキャン実行されます。このファンクションで、変数ArrayOfIntの要素数を求めます。この例の結果は、NumberOfDim1 = 14、NumberOfDim2 = 18、NumberOfDim3 = 22となります。

LDボディ

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 6 ;
        NETWORK_BODY
B(B_VARIN,,ArrayOfInt,6,2,8,4,);
B(B_VAROUT,,NumberOfDim1,19,2,21,4,);
B(B_F,Elem_OfArray3D!,Instance,8,1,19,6,,?DArray3D?CNrOfElem1?CNrOfElem2?CNrOfElem3);
B(B_VAROUT,,,19,3,21,5,);
B(B_VAROUT,,,19,4,21,6,);
L(1,0,1,6);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

プロジェクトのサンプルは、FPWIN Pro CDに収納されています。インストール先の"Samples"フォルダから、以下のファイルを開いてください。Calculate the trace of a three-dimensional array (FB) (3次元配列のトレースの計算)