HSPHelp:dirlist

• →HSPHelp:Dに戻る

dirlist

dirlist p1,"filemask",p2                        [ディレクトリ一覧を取得]

p1=変数 : ディレクトリ一覧を格納する文字列型変数
"filemask" : 一覧のためのファイルマスク
p2=0〜(0) : ディレクトリ取得モード

説明

カレントディレクトリのファイル一覧を作成して、変数に代入します。 "filemask"で、一覧を作成するためのファイルマスクを指定します。ファイルマスクは、 「*.*」のようなワイルドカードの形で指定するパラメータです。たとえば、 「*.as」というファイルマスクではasという拡張子を持つファイルすべての一覧を作成します。 カレントディレクトリにあるすべてのファイル一覧を作成する場合は、「*.*」になります。 ディレクトリ一覧は、p1で指定された文字列型の変数に、 １ファイルごとに「\n」で区切られた文字列として代入されます。このデータは、 メモリノートパッド命令で扱うことができる形式です。

変数に指定されたバッファよりも大きなサイズが代入される場合には、 自動的に新しいサイズで確保し直して実行を行ないます(バッファ自動増加機能)。 ver2.55までは、ディレクトリ一覧のためにある程度のメモリ容量を確保しておく必要がありましたが、 ver2.6以降は自動的に確保されるためメモリサイズを気にする必要はありません。

HSPHelp:dirlist命令が実行されると、システム変数statに一覧が作成されたファイルの数が代入されます。 ファイルが１つもない場合は、システム変数statに0が代入されます。 p2のモードを指定することによって、取得するファイルの種類を選ぶことができます。 モード値の詳細は以下の通りです。モードが省略されている場合は0になります。

("filemask"にDOSのファイル名またはディレクトリ名を指定すると、 長いファイル名・ディレクトリ名に変換することができます。)

備考

ver2.6標準命令