---

OBJLIST

OBJLISTファンクションは、指定した1つ以上のワークスペースに含まれるオブジェクトのリストを表示します。OBJLISTによって返されるワークスペース・オブジェクトのリストでは、重複項目が削除され、昇順にソートされます。このファンクションを使用するときは、指定のワークスペースがアタッチされている必要があります。

結果の複数行のTEXT値は、REFERSキーワードと組み合せたOBJファンクションの引数として使用できます。このように使用すると、現行のワークスペースにあるコンパイル可能なオブジェクト(プログラム、モデルなど)の相互参照リストを生成するときに役立ちます。

注意: OBJLISTは、NAMEディメンションを制限している場合でも常に、指定のワークスペースに存在するすべてのオブジェクトの名前を返します。

戻り値

TEXT

構文

OBJLIST[(text-expression)]

パラメータ

text-expression

現在アタッチされているワークスペースの1つまたは複数の名前が含まれるテキスト式。各ワークスペース名は、複数行のTEXT値の1行ごとに記述する必要があります。この引数を指定しなかった場合、OBJLISTは現行のワークスペース名を使用します。text-expressionに、アタッチされていないアナリティック・ワークスペースの名前が含まれる場合、OBJLISTは値を返しません。かわりにエラーが通知されます。

例

例8-57 3つのワークスペースにあるオブジェクトのリスト表示

次の例では、OBJLISTは、指定した3つのワークスペース(mycode、mydataおよびmytools)にあるすべてのオブジェクトを含む複数行のTEXT値を返します。次の文

SHOW OBJLIST('mycode\nmydata\nmytools')

によって、次の出力が生成されます。

ACTUAL
ADDFIVE
ADVERTISING
BUDGET
CITYLIST
CITYREPINIT
CITYREPS
    ...
YEAR

例8-58 参照されるオブジェクトのリスト表示

次の例では、OBJ(REFERS)は、mycode、mydataおよびmytoolsのワークスペースにあるオブジェクトのうち、myprogプログラムによって参照されるすべてのオブジェクトを含む複数行のTEXT値を返します。次の文

SHOW OBJ(REFERS OBJLIST('mycode\nmydata\nmytools') 'myprog')

によって、次の出力が生成されます。

ACTUAL
BUDGET
 ...
YEAR