Functions.FFCount 方法 | |
返回与给定文件规范和属性匹配的文件数量。
命名空间:
XSharp.Core
程序集:
XSharp.Core (在 XSharp.Core.dll 中) 版本:2.22 GA
语法 FUNCTION FFCount(
pszFileSpec AS STRING,
dwAttributes AS DWORD
) AS DWORD
public static uint FFCount(
string pszFileSpec,
uint dwAttributes
)
查看代码参数
- pszFileSpec
- 类型:String
要包含的文件名,包括可选的驱动器、目录和扩展名。
文件名和扩展名可以包含标准通配符(* 和 ?)。
如果省略驱动器和目录,则使用 Windows 默认值。
- dwAttributes
- 类型:UInt32
以下一个或多个常量,指示要与 pszFileSpec 一起用作搜索条件的文件属性:
常量 描述
FA_DIRECTORY 目录
FA_VOLUME 卷
FC_HIDDEN 隐藏
FC_NORMAL 可见
FC_SYSTEM 系统
要指定多个常量,可以将属性相加,如 FC_SYSTEM + FC_HIDDEN,或使用 _Or() 运算符,如 _Or(FC_SYSTEM, FC_HIDDEN)。
dwAttributes 指定除与 pszFileSpec 匹配的任何"可见"文件之外要满足的条件。可见文件不包括目录、卷或隐藏或系统文件 — 所有其他文件都是可见的,无论其读取或存档属性的状态如何。
要仅包含可见文件,请使用 FC_NORMAL 作为 dwAttributes 参数。
注意:要仅指定卷标,排除所有其他文件,请将 FA_VOLUME 指定为唯一的 dwAttributes 参数。
返回值
类型:
UInt32
匹配指定条件的文件数量。
如果未找到匹配项,则返回零。
备注
FFCount() 还会找到与指定条件匹配的第一个文件。
因此,在 FFCount() 之后不需要立即调用 FFirst()。相反,可以使用其他相关函数(如 FName()、FSize()、FAttrib()、FTime() 或 FDate())检索有关第一个匹配文件的必要信息,然后调用 FNext() 移动到下一个文件。
下面的示例说明了这种技术。
示例
此示例使用 FFCount() 与 FNext() 和 FName() 结合,显示所有与 "C:\DOCS\*.TXT" 匹配的文件:
1dwMatches := FFCount("c:\docs\*.txt", FC_NORMAL)
2FOR i:= 1 UPTO dwMatches
3 ? FName()
4 FNext()
5NEXT
此示例说明了
dwAttributes 参数的用法,将文件搜索扩展到包括隐藏文件和目录以及可见文件:
1dwCnt := FFCount("c:\i*.*", FC_HIDDEN + FA_DIRECTORY)
2FOR i:= 1 UPTO dwCnt
3 ? FName()
4 FNext()
5NEXT
参见