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> を解放する。
このコマンドはファイル検索処理が不要になった時点で、即座に実行されなければならない。

例

extpat='*.txt'
findfirst dh extpat filename

while result
	messagebox filename extpat
	findnext dh filename
endwhile

findclose dh