4D Doc Center : CREATE SET FROM ARRAY

4D v14.3

CREATE SET FROM ARRAY


CREATE SET FROM ARRAY ( aTable ; recordsArray {; setName} )

引数	型	説明
aTable	テーブル	セットのテーブル
recordsArray	倍長整数, ブール配列	レコード番号配列、またはブール配列 (True = レコードはセットに含まれる, False = レコードはセットに含まれない)
setName	文字	作成するセットの名前, または省略時、UserSetに適用する

説明

CREATE SET FROM ARRAY コマンドは、セットsetNameを下記の情報から作成します:

aTableテーブルの絶対レコード番号の配列recordsArray
ブール配列recordsArray。この場合、配列の値はそれぞれのレコードがsetNameに属する (True) か属さないか (False) を表します。

このコマンドを使用する際、recordsArrayに倍長整数配列を渡すと、配列中のすべての数値はsetNameに格納されるレコードのレコード番号を表します。番号が無効の場合 (例えばレコードが作成されていない場合)、エラー-10503が生成されます。

このコマンドを使用する際、recordsArrayにブール配列を渡すと、配列のN番目の要素は、setNameにN番目のレコードが含まれるか (True) 含まれないか (False) を表します。通常配列の要素数はテーブルのレコード数と一致しなくてはなりません。配列要素数がレコード数より少ない場合、配列により定義されたレコードのみがセットに格納されます。

Note: ブール配列では0からN-1までの要素がこのコマンドにより使用されます。

setName 引数を渡さないか空の文字列を渡すと、コマンドはUsersetシステムセットに適用されます。

エラー管理

倍長整数配列を渡した場合で、レコード番号が無効 (レコードが作成されていない) のとき、エラー-10503が生成されます。