GETLIST ステートメント

構文

GETLIST listname [TO list.number] [SETTING variable] 
{THEN statements [ELSE statements] | ELSE statements}

説明

GETLIST ステートメントを使用すると、保存した選択リストを READNEXT ステートメントで使用できるように、その選択リストをアクティブにできます。

listname は、以下の形式として評価される式です。

record.ID

または、

record.ID account.name

record.ID は、&SAVEDLISTS& ファイル内の選択リストのレコード ID です。account.name が指定されると、ローカル・アカウント内のファイルの代わりに、&SAVEDLISTS& ファイルが使用されます。

listname が NULL 値として評価されると、GETLIST ステートメントは正しく実行されずプログラムはランタイム・エラー・メッセージを出力して終了します。

TO 節は、リストを選択リスト番号の 0?10 に格納します。list.number が指定されない場合、リストは選択リスト 0 として保存されます。

SETTING 節は、リスト内のエレメントの数を variable に割り当てます。システム変数の @SELECTED も、SETTING 節の有無に関係なくこの数に割り当てられます。 リストが正しく検索されると、リストが空であっても THEN 文が実行されます。それ以外は ELSE 文が実行されます。

PICK、REALITY、および IN2 フレーバー

PICK、REALITY、および IN2 フレーバー・アカウントでは、選択リストを、番号の付いた選択リストではなくリスト変数に格納します。これらのアカウント、および、$OPTIONS 文の VAR.SELECT オプションを使用するプログラムでの、GETLIST 文の構文は次のとおりです。

GETLIST listname [TO list.variable] [SETTING variable] 
{THEN statements [ELSE statements] | ELSE statements}