点击或拖拽改变大小

Functions.FFCount 方法

X#
返回与给定文件规范和属性匹配的文件数量。

命名空间:  XSharp.Core
程序集:  XSharp.Core (在 XSharp.Core.dll 中) 版本:2.22 GA
语法
 FUNCTION FFCount(
	pszFileSpec AS STRING,
	dwAttributes AS DWORD
) AS DWORD
查看代码

参数

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" 匹配的文件:
X#
1dwMatches := FFCount("c:\docs\*.txt", FC_NORMAL)
2FOR i:= 1 UPTO dwMatches
3    ? FName()
4    FNext()
5NEXT
此示例说明了 dwAttributes 参数的用法,将文件搜索扩展到包括隐藏文件和目录以及可见文件:
X#
1dwCnt := FFCount("c:\i*.*", FC_HIDDEN + FA_DIRECTORY)
2FOR i:= 1 UPTO dwCnt
3    ? FName()
4    FNext()
5NEXT
参见