選択ステートメント

カーソル指定される表の中から条件を満たすレコードを選択します。

形式

パラメータ

<カーソル名>

選択を実行または解除するウィンドウを指定します。省略するとカレントカーソルが指すウィンドウが対象となります。
追加選択=する，補集合選択，解除 および 全解除 の場合は，選択ウィンドウを指すカーソルでなければなりません。

<論理式>

選択する条件を任意の論理式で指定します。条件式指定 の場合と異なり，式を直接記述します。
たとえば，[項目A]='ABC' のような単純な比較を行なう選択では，条件式指定 で記述した方が最適化が効果的に行なわれます。<論理式> による指定よりも 条件式指定 の形式を利用することをお勧めします。

条件名指定

表にあらかじめ登録してある探索条件を使用して選択するときに指定します。

<条件名>

表に登録してある探索条件の名前を文字列式で指定します。条件名指定 のときのみ意味をもちます。古いバージョンとの互換性のために，条件名= の形で書くこともできます。

条件式指定

任意の条件式を文字列式で指定して選択するときに指定します。選択の速度が重要な場合，<論理式> よりも効果的な最適化が行なわれる可能性があるので，この 条件式指定 による形式を使うことをお勧めします。

<条件式>

選択条件になる論理式を文字列式として指定します。ステートメント中に <論理式> を直接記述する場合と異なり，ここでの条件は文字列式で指定し，その値が論理式として評価されます。

現在位置レコード

<カーソル名> が指すレコードを１レコードだけ選択します。

注：

DBPro V3 までの「現レコード」パラメータは，後述の セルカーソル位置レコード が対応します。現在位置レコード で選択されるレコードは，セルカーソル位置のレコードではなく，<カーソル名> が指しているレコードですので注意してください。

現在位置グループ

<カーソル名> が指すレコードが属するグループのレコードを選択します。カード編集ウィンドウでなかったり，グループが定義されていなかったりしたときは，現在位置のレコードだけが選択されます。

セルカーソル位置レコード

<カーソル名> が指すウィンドウのセルカーソルがあるレコードを１レコードだけ選択します。

注：

DBPro V3 までの「現レコード」パラメータに対応します。
カーソル移動ステートメントや検索ステートメントで対象となるレコードを特定した後，そのレコード位置をカーソル変数に保存して別のカーソル移動ステートメントなどを実行すると，セルカーソルの位置は移動してしまいます。保存しておいたカーソル変数の値によってレコード選択したい場合は，現在位置レコード を使ってください。

セルカーソル位置グループ

<カーソル名> が指すカード編集ウィンドウで，セルカーソルのあるレコードが属するグループのレコードを選択します。カード編集ウィンドウでなかったり，グループが定義されていなかったりしたときは，セルカーソル位置のレコードだけが選択されます。

補集合

<カーソル名> が指す選択状態の表の補集合を選択します。これは，現在の選択表の直前の元になっている表に対する補集合となります。<カーソル名> で示される表が選択表でないときは$$CMDSTATEに201が返ります。

実行時指定

条件選択ダイアログを表示して，実行時に選択条件や使用索引を指定します。

解除

<カーソル名> が指す選択ウィンドウを閉じ，選択の元になった直前のウィンドウに戻ります。<カーソル名> は選択状態でなければなりません。

全解除

<カーソル名> が指す選択ウィンドウの一番元になっている実表のウィンドウまで戻り，その実表から現在の選択ウィンドウに至るまでの途中の選択ウィンドウをすべてクローズします。<カーソル名> は選択状態でなければなりません。

現在位置レコード除外

<カーソル名> が指すレコードを１レコードだけ選択除外します。<カーソル名> は選択状態でなければなりません。

セルカーソル位置レコード除外

<カーソル名> が指す選択ウィンドウから，そのウィンドウのセルカーソルがあるレコードを１レコードだけ選択除外します。<カーソル名> は選択状態でなければなりません。

索引自動判定

索引自動判定を行なうかどうかを指定します。

する	高速な選択のために使用できる索引を自動的に判定して選択します。整列状態は現在のものと変わる可能性があります。
しない	索引の自動判定はしないで，現在の整列状態のまま選択します。（既定値）

追加選択

<カーソル名> で示される選択状態のウィンドウに追加選択をすることができます。追加選択をすると，条件を満たすレコードが <カーソル名> で示される選択ウィンドウに追加されます。

する	追加選択をします。このとき，<カーソル名> で示されるウィンドウは選択ウィンドウでなければなりません。選択ウィンドウでないときは$$CMDSTATEに201が返ります。
しない	追加選択をせず，新しいウィンドウを開きます。（既定値）

追加選択中に中止ボタンが押されると，その時点までの選択結果は <カーソル名> で示される選択ウィンドウに追加されています。

空選択

条件を満たすレコードが一つもないとき，空の選択ウィンドウを作るかどうか指定します。空の選択表を作るときは，$$CMDSTATEに22が返ることはありません。

する	空の選択ウィンドウを作ります。
しない	空の選択ウィンドウを作りません。（既定値）

ウィンドウ表示

選択された結果をウィンドウに表示するか，しないか指定します。省略すると，選択前のウィンドウが表示されていれば する に，表示されていなければ しない になります。解除 および 全解除 のときに省略すると，戻り先のウィンドウがすでに存在する場合にはそのウィンドウの，戻り先のウィンドウが存在せずに現在のウィンドウに表示される場合には現在のウィンドウの表示状態と同じになります。

する	新しいウィンドウが生成されて，そのウィンドウに表示されます。
同じウィンドウ	同じウィンドウに表示されます。同じウィンドウに表示した場合，それまでの <カーソル名> が指していたウィンドウはいったん閉じられて，同じカーソルに新しいウィンドウが割り当てられたのと同じ効果になります。すなわち，以前のカーソルが別のカーソル変数に保存してあったとしても，その内容は不定になります。
しない	ウィンドウは表示されません。

レコード数 （V4.5追加）

選択されるレコード数を制限します。ここで指定したレコード数に達すると選択は終了します。指定しなかった場合や 0 を指定したときは，条件を満たすレコードがすべて選択されます。

結果

例

構造	コマンド	パラメータ
	オープン	@MASTER, 'MASTER.DPT'
	選択	@MASTER, [商品番号]=1000
IF $$CMDSTATE = 0 THEN
	代入	@SELECT := @@
	印刷	@SELECT, 標準
	クローズ	@SELECT
ENDIF

解説

• 条件の指定方法については検索ステートメントと同じです。検索ステートメント：解説
  特に，<論理式> を直接記述する形式よりも 条件式指定 による条件指定の方が最適化が効果的に行なわれる件は，検索よりも選択において顕著に現われますのでご注意ください。
• 選択結果の表は，カレントカーソルによって指されます。一般的には，カレントカーソルを別のカーソル変数に代入して，以後の操作を続けます。
• 選択の元になった表（被選択表）がクローズされると選択表もクローズされます。
• 選択解除した場合，たとえ結果が現在のウィンドウと同じウィンドウに表示された場合でも，<カーソル名> は不定になるので，以後の操作はカレントカーソルに設定された値を使って行なってください。

関連項目

機能ガイド：選択と選択ウィンドウ

論理式と論理値

[探す]-[条件選択]

[探す]-[選択解除]

[探す]-[選択全解除]

検索ステートメント

項目選択ステートメント

単一化選択ステートメント

重複レコード選択ステートメント

DPLの構文

$$CMDSTATE一覧