Functions.ADir 方法 | |
用目录信息填充一系列数组。
注意:
ADir() 是一个兼容性函数,因此不推荐使用。
它被 Directory() 函数取代,后者将所有文件信息返回在一个多维数组中。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION ADir(
cFileSpec,
acFileNames,
anSizes,
adDates,
acTimes,
acAttributes
) AS DWORD CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static uint ADir(
__Usual cFileSpec = default,
__Usual acFileNames = default,
__Usual anSizes = default,
__Usual adDates = default,
__Usual acTimes = default,
__Usual acAttributes = default
)
查看代码参数
- cFileSpec (Optional)
- 类型:__Usual
目录搜索的文件规范。
除了文件名外,此规范可能包括可选的驱动器、目录和扩展名。
文件名和扩展名可以包含标准通配符(* 和 ?)。
如果未指定驱动器和目录,此函数将使用 SetDefault() 设置。
- acFileNames (Optional)
- 类型:__Usual
用匹配 cFileSpec 的文件名填充的数组。
每个元素将包含文件名和扩展名作为字符串,全部为大写字母。
- anSizes (Optional)
- 类型:__Usual
用 acFileNames 中相应文件的大小填充的数组。
- adDates (Optional)
- 类型:__Usual
用 acFileNames 中相应文件的日期填充的数组。
- acTimes (Optional)
- 类型:__Usual
用 acFileNames 中相应文件的时间填充的数组,格式为 hh:mm:ss。
- acAttributes (Optional)
- 类型:__Usual
用 acFileNames 中相应文件的属性填充的数组。
如果指定了 acAttributes,则包括隐藏、系统和目录文件以及普通文件。
如果未指定 acAttributes,则只包括普通文件。
返回值
类型:
UInt32
匹配
cFileSpec 中描述的目录模式的文件数量。
备注
ADir() 执行两个基本操作。
首先,它返回匹配文件规范的文件数量。
其次,它用文件名、大小、日期、时间和属性填充一系列数组。
注意,所有数组参数必须在调用此函数之前存在,并且必须有足够大的大小来容纳函数结果。
提示: |
---|
如果指定了 acAttributes,并且 cFileSpec 包含匹配目录名的模式(如 "*.*" 或 "*."),则目录会包含在 acFileNames 中。
它们用属性值 "D" 表示。
如果在子目录中执行 ADir(),acFileNames 的前两个条目是 "." 和 "..",即父目录和当前目录别名。
报告目录的最后更新日期和时间,但目录的大小始终为 0。
|
示例
这个例子创建一个数组来保存当前默认目录中所有 .TXT 文件的名称,然后使用 AEval() 将它们列出到控制台:
1LOCAL aFiles AS ARRAY
2aFiles := ArrayCreate(ADir("*.txt"))
3ADir("*.txt", aFiles)
4AEval(aFiles, {|element| QOut(element)})
参见