搜索指定字符串并返回(下一個)與之匹配的文件名,但要求在調用過 FileFindFirstFile 函數之后。
FileFindNextFile ( 搜索句柄 )
參數
| 搜索句柄 | 搜索句柄,由 FileFindFirstFile 函數返回。 |
返回值
| 成功: | 根據 FileFindFirstFile 函數的設置返回匹配的文件名。 |
| 失。 | 把 @error 設為 1,說明沒有找到更多匹配要求的文件或文件夾。 |
注意
必須先調用 FileFindFirstFile 函數來建立搜索并獲得搜索句柄。此后每次調用 FileFindNextFile 函數都會返回下一個與 FileFindFirstFile 函數提供的搜索字符串相匹配的文件名。如果 @error = 1 則說明已不能再找到匹配文件(搜索結束)。
相關
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
; 關閉搜索句柄
FileClose($search)