findfirst, findnext, findclose

# 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