Question

FileFindFirstFile

---

搜索指定字符串并返回与之匹配的文件名。

FileFindFirstFile ( "文件名" )

参数

文件名	要搜索的文件的完整或部分字符串（支持 *和 ? 等通配符）

返回值

成功：	返回一个搜索“句柄”或直接用于后来的 FileFindNextFile 函数。
失败：	返回值为 -1，说明遇到错误。

注意

要搜索的字符串是不区分大小写的。
通配符：一般而言，星号 * 可代替零个或多个字符，而问号 ? 则可代替零个或单个字符。若指定的搜索字符串中只有通配符（或者是"*.*"），请查看下面的示例并留意返回值！

在使用 FileFind...等函数完成搜索后务必调用 FileClose() 函数来释放搜索句柄。

相关

FileClose, FileFindNextFile

示例

; 显示当前目录下的所有文件的文件名，注意有返回 "." 和 ".."
$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)