9.69 FETCH_IN_SPACE

注意: 9.1 組み込み関数の規則      利用オプション

指定のキー値と最初に一致したセル行を取り出して、指定のフィールドへセル値を戻します。

 

引数

番号 タイプ 必須/任意 記述 最小長 最大長 最小小数桁数 最大小数桁数 1 A 必須 スペース名 1 256     2～20 X 任意  必要な最初のセル行を検出するためのキー値を指定するフィールド 1 無制限 0 無制限

戻り値

番号 タイプ 必須/任意 記述 最小長 最大長 最小小数桁数 最大小数桁数 1 A 任意 標準戻りコード OK = セル行が検出され、セル値が戻された NR = 指定のキー値に一致するセル行が検出されなかった ER = 選択が失敗した。発行されるメッセージに失敗の原因が示される 2 2     2～20 X 任意 選択されたセル行のセル値を受け取るフィールド 1 無制限 0 無制限

技術上の注記

戻りフィールドはスペースに定義されたセルと同じ順序で指定する必要があります。セルの仕様の順番通りに一致したセルは戻り値の2 -> 20に戻されます。使用されるフィールド名はセル・マッピングのロジックに何の関係もありません。

キー値がスペースで定義されたキー・セルの個数より多く指定された場合、超過分の値は無視されます。検索結果に影響はありません。

指定した戻りフィールド値の数が、スペース内のセルの数よりも少ない場合、未指定のセル値はフィールドに割り当てられません。

指定した戻りフィールド値の数が、スペース内のセルの数よりも多い場合、超過分のフィールド値は無視され、検索操作では何も変更されません。

指定のキー値が256バイトを超える場合、致命的なエラーが発生します。