SET QUERY DESTINATION
SET QUERY DESTINATION ( destinationType {; destinationObject {; destinationPtr}} )
引数 | 型 | 説明 | |
---|---|---|---|
destinationType | 倍長整数 | 🡒 | 0=カレントセレクション, 1=セット, 2=命名セレクション, 3=変数 |
destinationObject | 文字, 変数 | 🡒 | セット名、命名セレクション名、変数、または空の文字列 |
destinationPtr | ポインター | 🡒 | destinationType=3のとき変数へのポインター |
説明
SET QUERY DESTINATIONを使い、カレントプロセスのクエリの結果を配置する場所を4Dに指示することができます。
destinationType引数に配置場所のタイプを指定します。Queriesテーマの定義済み定数を使用することもできます:
定数 | 型 | 値 |
---|---|---|
Into current selection | 倍長整数 | 0 |
Into named selection | 倍長整数 | 2 |
Into set | 倍長整数 | 1 |
Into variable | 倍長整数 | 3 |
以下の表にしたがって、オプションのdestinationObject引数にクエリの配置先を指定します:
destinationType | destinationObject |
---|---|
引数 | 引数 |
0 (current selection) | 引数を省略します |
1 (set) | (既存のまたは作成させる) セット名 |
2 (named selection) | (既存のまたは作成させる) 命名セレクション |
3 (variable) | (既存の)数値変数、またはdestinationPtr引数を使用する場合空の文字列 ("") |
例:
SET QUERY DESTINATION(Into current selection)
以降の検索で見つかったレコードは、最終的にその検索の対象となるテーブルの新しいカレントセレクションとなります。
例:
SET QUERY DESTINATION(Into set;"mySet")
以降の検索で見つかったレコードは、最終的にセット"mySet"に配置されます。検索の対象となったテーブルのカレントセレクションとカレントレコードは変更されません。
例:
SET QUERY DESTINATION(Into named selection;"myNamedSel")
以降の検索で見つかったレコードは、最終的には命名セレクション"myNamedSel"に配置されます。検索の対象となったテーブルのカレントセレクションとカレントレコードは変更されません。
注:
- 命名セレクションが存在しない場合、検索が完了した時に自動的に作成されます。
- このコマンドはCUT NAMED SELECTIONと同様に命名セレクションを管理します。つまり参照だけが保持されます。命名セレクションをカレントセレクションに使用すると、命名セレクションは存在しなくなります。 例:
SET QUERY DESTINATION(Into variable;$vlResult)
注: このシンタックスでは、$vlResult 変数は事前に定義されている必要があります。そうでない場合、エラーが返されます。
または
SET QUERY DESTINATION(Into variable;"";->$vlResult)
注:この二つ目のシンタックスは、このコマンドをGET QUERY DESTINATIONと組み合わせて使用したい場合に便利です。
以降の検索で見つかったレコ ード数が、変数$vlResultに配置されます。検索の対象となったテーブルのカレントセレクションとカレントレコードは変更されません。
警告: SET QUERY DESTINATIONは、カレントプロセス内で行われた以下の検索のすべてに影響を及ぼします。destinationTypeが0でないSET QUERY DESTINATIONの呼び出しを行った後は、通常のクエリを再実行するためにSET QUERY DESTINATION(0)の呼び出しと対にさせることを忘れないでください。
SET QUERY DESTINATIONは、下記のクエリコマンドの動作を変更します:
- QUERY
- QUERY SELECTION
- QUERY BY EXAMPLE
- QUERY BY FORMULA
- QUERY BY SQL
- QUERY SELECTION BY FORMULA
- QUERY SELECTION WITH ARRAY
- QUERY WITH ARRAY
- QUERY BY ATTRIBUTE
- QUERY SELECTION BY ATTRIBUTE
これに対してSET QUERY DESTINATIONはALL RECORDSやRELATE MANY等、テーブルのカレントセレクションを変更する他のコマンドには影響を与えません。