指定したディレクトリからファイル名またはディレクトリ名を返します。またはドライブのボリュームラベルを返します。

構文Dir[$] [ ( fileSpec [ , attributeMask ] ) ]
構成要素fileSpec

戻り値として希望するパスまたはファイル名指定する文字列式です。この引数は、任意のパスに対して Dir$ を最初に呼び出すときのみ必要です。

fileSpec に標準のワイルドカード文字を指定することで、ワイルドカード文字にマッチするすべてのファイルを指定できます。ファイル名または拡張子にアスタリスク (*) を指定すると、その位置に任意の文字 (1 文字以上) が含まれるすべてのファイルを指定できます。疑問符 (?) を名前のいずれかの文字位置に指定すると、その位置に任意の 1 文字がくることを示します。

返される名前を指定する値を持つ整数式です。この引数を省略した場合、fileSpec に一致する通常のファイルを返します。attributeMask 引数を与えるときは、fileSpec 引数を与えなければなりません。

Dir$ は常に通常のファイルの名前を返します。戻り値のファイル名のリストに別のファイルを含めるには、次の表のファイルに対応する値の合計値を指定します。

マスク	ファイル属性	定数
0	通常ファイル	ATTR_NORMAL
2	隠しファイル	ATTR_HIDDEN
4	システムファイル	ATTR_SYSTEM
8	ボリュームラベル	ATTR_VOLUME。別の属性が指定されていると ATTR_VOLUME を無視します
16	ディレクトリ	ATTR_DIRECTORY

使用法表にある定数は、lsconst.lss ファイル内に定義されています。このファイルをスクリプトに取り込めば、数値の代わりに定数名を使えます。
ある特定のファイルが存在するかどうかを調べるには、file_spec に展開された名前を指定して Dir か Dir$ を使います。戻り値はファイル名か、存在しなければ空の文字列 ("") です。

最初の Dir か Dir$ の実行では、fileSpec の記述に一致する指定ディレクトリ内の最初のファイル名を返します。その後は、次のように処理が行われます。

• 続けて引数なしで Dir または Dir$ を実行すると fileSpec に一致する次のファイル名を得られます。引数なしの関数 Dir は Dir でも Dir( ) でも記述できます。引数なしの Dir$ 関数は Dir$ でも Dir$() でも記述できます。
• 記述に合うようなファイルがこれ以上ない場合は、Dir は DataType 8 (String) の Variant 型を返し、Dir$ は空の文字列 ("") を返します。

Dir または Dir$ 関数を再起的に呼び出すことはできません。

例
関連項目

LotusScript ランゲージリファレンス: A - D
ChDir ステートメント
CurDir 関数
%Include 命令
Macintosh プラットフォームでの違い
UNIX プラットフォームでの違い
LotusScript での OS/400 プラットフォームの違い

用語集