函数说明

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)