メインコンテンツまでスキップ
バージョン: 開発中

CREATE SET FROM ARRAY

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

引数説明
aTableTableセットのテーブル
recordsArrayInteger, Boolean arrayレコード番号配列、または ブール配列 (True = レコードはセットに含まれる, False = レコードはセットに含まれない)
setNameText作成するセットの名前, または 省略時、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が生成されます。

参照

BOOLEAN ARRAY FROM SET
CREATE SELECTION FROM ARRAY