Function Reference

FileFindNextFile

FileFindFirstFileの呼び出し結果に基づいてファイル名を返します。

FileFindNextFile ( search )

 

パラメータ

search FileFindFirstFileが返す検索文字列。

 

返し値

成功 FileFindFirstFileの呼び出し結果に基づいてファイル名を返します。ファイル名がディレクトリの場合@extendedを1に設定します。
失敗 検索に一致するファイル/ディレクトリがない場合@errorを1に設定します。

 

注意

検索準備と検索ハンドル取得のためのFileFindFirstFileの呼び出しは必須です。FileFindFirstFileで指定された検索文字列に基づいてFileFindNextFileの呼び出し毎に見つかったファイルが返されます。@error = 1の場合、元の検索文字列に一致するファイルは存在しません。

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

 

関連

FileClose, FileFindFirstFile

 


; 現在のディレクトリ内の全てのファイルのファイル名を表示
$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)