Function Reference

FileFindFirstFile

ファイル検索文字列に従って検索"ハンドル"を返します。

FileFindFirstFile ( "filename" )

 

パラメータ

filename ファイル検索文字列。(*?のワイルドカードが使用可能です。)

 

返し値

成功 FileFindNextFileで使用するための検索"ハンドル"を返します。
失敗 エラーが起きた場合-1を返します。フォルダが空の場合、@errorを1に設定します。

 

注意

検索文字列は大文字小文字の区別をしません。
ワイルドカード:一般に*はゼロ文字以上の文字を意味し、?はゼロまたは1文字の文字を意味します。ワイルドカード(もじくは"*.*")のみのファイル検索文字列を使用した場合の返り値については例を参照してください。

ワイルドカードはファイル名、拡張子部分のみに使用できます。 例:a*.b?
??は*と解釈されます(Microsoftドキュメンテーションには書かれていません)。
3文字の拡張子を使用すると同じ3文字で始まる拡張子は全て検索に一致します。例:"test.log_1"は"*.log"に一致します(これもMicrosoftドキュメンテーションには書かれていません)。

FileFind...関数による検索を終了する場合には検索ハンドルを解放するためにFileClose() を呼ぶ必要があります。

いかなる場合でもワイルドカードに従ってディレクトリ名が返されます。

 

関連

FileClose, FileFindNextFile

 


; 現在のディレクトリ内の全てのファイルのファイル名を表示
$search = FileFindFirstFile("*.*")  

; 検索が成功したかを調べる
If $search = -1 Then
    MsgBox(0, "Error", "No files/directories matched the search pattern")
    Exit
EndIf

While 1
    $file = FileFindNextFile($search)
    If @error Then ExitLoop
   
    MsgBox(4096, "File:", $file)
WEnd

; 検索ハンドルを閉じる
FileClose($search)