搜索指定字符串并返回(下一個)與之匹配的文件名,但要求在調(diào)用過 FileFindFirstFile 函數(shù)之后。
FileFindNextFile ( 搜索句柄 )
參數(shù)
搜索句柄 | 搜索句柄,由 FileFindFirstFile 函數(shù)返回。 |
返回值
成功: | 根據(jù) FileFindFirstFile 函數(shù)的設(shè)置返回匹配的文件名。 |
失。 | 把 @error 設(shè)為 1,說明沒有找到更多匹配要求的文件或文件夾。 |
注意
必須先調(diào)用 FileFindFirstFile 函數(shù)來建立搜索并獲得搜索句柄。此后每次調(diào)用 FileFindNextFile 函數(shù)都會返回下一個與 FileFindFirstFile 函數(shù)提供的搜索字符串相匹配的文件名。如果 @error = 1 則說明已不能再找到匹配文件(搜索結(jié)束)。
相關(guān)
FileClose, FileFindFirstFile
示例
; 顯示當前目錄下的所有文件的文件名
$search = FileFindFirstFile("*.*")
; 檢查搜索是否成功
If $search = -1 Then
MsgBox(0, "錯誤", "無任何文件或文件夾與指定的搜索字符串匹配")
Exit
EndIf
While 1
$file = FileFindNextFile($search)
If @error Then ExitLoop
MsgBox(4096, "文件:", $file)
WEnd
; 關(guān)閉搜索句柄
FileClose($search)