findfirst

文字列にあう最初のファイルを探す。

findfirst <dir handle> <file name> <strvar>

解説

findfirst コマンドはファイル名 <file name> にあう最初のファイルを探す。
ファイルが見つかった場合、ディレクトリハンドルが <dir handle> に、最初のファイル名が <strvar> に格納され、システム変数 <result> に 1 が格納される。
findfirst コマンドが最初のファイルを見つけた場合、ディレクトリハンドルを指定して findnext コマンドを使用し、 <file name> にあう次のファイルを探すことができる。
ディレクトリハンドルは findclose コマンドによって解放されなければならない。

findnext

文字列にあう次のファイルを探す。

findnext <dir handle> <strvar>

解説

findnext コマンドは findfirst コマンドで指定されたファイル名にあう次のファイルを探す。
整数値 <dir handle> は findfirst コマンドで得られたディレクトリハンドルでなければならない。
もし次のファイルが見つかった場合、<strvar> にファイル名が、"result" に 1 が格納される。
それ以外の場合は、<strvar>と "result" にそれぞれ "" と 0 が格納される。

findclose

ディレクトリハンドルを解放する。

findclose <dir handle>

解説

findclose コマンドは findfirst コマンドによって得られたディレクトリハンドル <dir handle> を解放する。
このコマンドは findfirst コマンドがファイルを見つけた場合、実行されなければならない。

例

findfirst dh '*.txt' filename

while result
messagebox filename '*.txt'
findnext dh filename
endwhile

findclose dh