9.214 TEMPLATE_@@GET_FILS

この機能は、指定のベース・ファイル名から関連するすべてのファイルのリストを呼び出し元に戻します。 

この組み込み関数は、機能上、指定のベース・ファイル名からファイルのリストを戻すという点で、アプリケーション・テンプレート・コマンド @@GET_FILSの最初のステップのように動作します。 

テンプレートでは、コマンドによって、ユーザーに結果リストが表示され、ユーザーはそのリストから選択することができます。ただし、組み込み関数のバージョンでは、呼び出し元のRDMLファンクションにリストが戻されます。 

アプリケーション・テンプレートでは、ユーザーは、ワークステーションでファイルの横にブランク以外の値を入力することによってファイルを選択します。 RDMLファンクションからこのアクションを実行するには、TEMPLATE_@@SET_FILS組み込み関数を使用します。 

この組み込み関数は、START_FUNCTION_EDIT組み込み関数によってすでに編集セッションに入っているファンクションに対してのみ使用することができます。 

基本的な違いは、このファンクションによって、より広範囲のファイル・アクセス経路リストを抽出できるという点です。オンライン・バージョンでは、ファイル・リスト全体で、基となる同じ物理ファイルを複数回抽出することはできません。ただし、この組み込み関数ではこのルールを緩和し、ベース・ファイルから始まるおよびベース・ファイルを含む1つのアクセス経路「チェーン」または「パス」で基となる同じ物理ファイルを複数回使用できないようにしています。 

この制限は、アクセス経路の「チェーン」または「パス」内で「閉じた回路」または「無限ループ」が発生するのを防ぐために必要です。 

このファンクションを使用する予定の開発者は、この組み込み関数を使用する簡単なテスト・ファンクションを設計することによって、指定のベース・ファイルからファイルを抽出し、結果のファイル・リストを表示してみることを強くお勧めします。これによって、このファンクションの特性を非常に簡単に検証し、理解することができます。 

この BIF は、9.2 開発環境のみで使用される組み込み関数 です。

引数

戻り値