SEARCH 文
SEARCH (表引き) 文は、 表を検索して、指定された条件を満たす表要素を検出し、関連付けられた指標名がその表要素を指すように調整するために使用します。
すべての書き方 (すべてのファイル) の構文規則
- 一意名-1 には添字または指標を付けてはならない。このデータ記述には、OCCURS 句と INDEXED BY BY 句が含まれていなければならない。書き方 2 では、一意名-1 のデータ記述の OCCURS 句内に、KEY IS 指定も含まれていなければならない。
- 一意名-2 を指定する場合、指標データ項目 (USAGE IS INDEX) または想定される小数点の右に何もない整数データ項目とする。
END-SEARCH 指定を書いた場合、NEXT SENTENCE 指定を書いてはならない。
END-SEARCH 指定と NEXT SENTENCE 指定を同時に書いてもよい。NEXT SENTENCE 指定が実行されると、制御は END-SEARCH 指定の後ろに続く次の文に移されるのではなく、最も近い終止符 (.) の後ろの文に移される。- 無条件文-1 および無条件文-2 の代わりに、条件文を使用してもよい。
書き方 2 の構文規則
- 使用する条件名は、すべて単一の値を持つものとして定義しておく。条件名に関連するデータ名は、一意名-1 の KEY 句の中に記述しておく。データ名-1、データ名-2 はそれぞれ修飾できる。データ名-1、データ名-2 は、それぞれ他の必要な指標やリテラルとともに、一意名-1 用の最初の指標名によって指標付けしておき、一意名-1 の KEY 句の中に記述しておく。一意名-3、一意名-4、または算術式-1、算術式-2 の中で使用する一意名は、一意名-1 の KEY 句の中に記述してあってはならず、一意名-1 用の最初の指標名によって指標付けしてあってもならない。
一意名-1 の KEY 句の中のデータ名を使用するとき、または一意名-1 の KEY 句の中のデータ名に関連する条件名を使用するとき、一意名-1 の KEY 句の中のそのデータ名の前にあるすべてのデータ名またはそれらに関連する条件名を使用する。
一意名-1 (つまり表引きの対象とする表要素) は、浮動小数点数であってはならない。- キー データ項目であるデータ名-1およびデータ名-2は浮動小数点数であってならない。しかし、キー データ項目と比較する対象の一意名-3、一意名-4、定数-1、定数-2は、浮動小数点数であってもよい。
すべての書き方の一般規則
- SEARCH 文の範囲は、下記のいずれかによって区切られる。
- 実行された無条件文-1 または無条件文-2 に GO TO 文が含まれていなければ、制御は次の実行完結文に移される。
- 2 次元または 3 次元の表を作成するための OCCURS 句が含まれるデータ項目の下位に一意名-1 が属する場合、OCCURS 句の INDEXED BY 句を通じて、表の各次元ごとに指標名を付ける。SEARCH 文 が実行されると、一意名-1 用の指標名 (および指定されていれば一意名-2 または指標名-1) だけが、値を変えられる。2 次元または 3 次元の表の全体を表引きするためには、SEARCH 文を数回実行する必要がある。指標の値を調整する必要がある場合には、SEARCH 文を実行する前に、SET 文を実行しておく。
逐次表引き書き方 1 の一般規則
- 書き方 1 の SEARCH 文を用いると、逐次表引き処理が行われる。このときの指標の値が、その開始点となる。
- SEARCH 文の実行が開始される時点で、一意名-1 用の指標データ項目の値が出現番号の最大値よりも大きいと、その SEARCH 文の実行は直ちに停止される。一意名-1 の出現番号の最大値の詳細については、OCCURS 句に説明してある (「データ部 - データ記述」の章の「OCCURS 句」のセクションを参照)。このとき、AT END 指定が書いてあれば、無条件文-1 が実行される。AT END 指定が書いてなければ、制御は次の実行完結文に移される。
- SEARCH 文の実行が開始される時点で、一意名-1 用の指標データ項目の値が出現番号の最大値を超えないと、その SEARCH 文の処理が進められる (一意名-1 の出現番号の最大値の詳細については、「OCCURS 句」に説明してある)。まず、条件が書かれている順に評価される。この際、指定されていれば、検査の対象となる要素の出現番号を判定するために、指標データ項目の値が使用される。条件が満足されていない場合は、指標データ項目の値が増やされて、次の要素が参照できるようにされる。この処理が順次繰り返される。一意名-1 用の指標データ項目の値が出現番号の最大値を超えると、上記の一般規則 1a に示すとおり、その表引き処理は終了する。この間にどこかの時点で条件が満足されると、表引き処理は直ちに停止され、その条件に付随する無条件文が実行される。このとき、その指標データ項目には、条件を満足させた要素の出現番号が記録されている。
- VARYING 指定を書かなかった場合、表引き処理に使用される指標名は、一意名-1 の INDEXED BY 句の中の最初の (または唯一の) 指標名だけである。一意名-1 用のその他の指標名の指標データ項目の内容は変わらない。
- VARYING 指標名-1 指定を書いた場合、一意名-1 の INDEXED BY 句の中に指標名-1 が書いてあれば、その指標名がこの表引き処理に使用される。そうでない場合、または VARYING 一意名-2 指定を書いた場合、一意名-1 の INDEXED BY 句の中の最初の (または唯一の) 指標名が表引きに使用される。この場合、さらに下記の処理も行われる。
非逐次表引き書き方 2 の一般規則
- SEARCH 文で、SEARCH ALL の処理結果が正しく得られるためには、下記の条件が共に満たされる必要がある。
- 書き方 2 の SEARCH 文を用いると、非逐次表引き処理が行われる。このとき、一意名-1 用の指標データ項目の初期値は無視され、表引き処理につれて指標データ項目の値は変化する。ただし、その値が許される最大値よりも大きくなることも、許される最小値よりも小さくなることもない。表の大きさについては、「OCCURS 句」に説明してある。許容範囲内のどの指標値に関しても WHEN 句に指定された条件のうちで満たされないものがある場合、AT END 指定が書いてあれば、その無条件文-1 に制御が移される。AT END 指定が書いてなければ、次の実行完結文に制御が移される。どちらの場合も、指標データ項目の最後の値はどうなるかわからない。すべての条件が満たされたときは、そのときの要素の出現番号が指標データ項目に記録され、制御は無条件文-2 に移される。
- 書き方 2 では、表引き処理に使用される指標名は、一意名-1 の INDEXED BY 句の中の最初の (または唯一の) 指標名だけである。一意名-1 用のその他の指標名の指標データ項目の内容は変わらない。
- 無条件文-2も NEXT SENTENCE 指定も必要ない。これらが指定されていないと、SEARCH 文は表の中の条件に一致した値に指標を設定する。
説明：
図 1 に、WHEN 指定が 2 つ含まれる書き方 1 の表引き処理の流れ図を示す。