adir()函数.txt

Vfp 文档 一些经典编程文章 可供初学者学习编程时使用

ADIR（）函数

    将文件信息存放到数组中。
语法
ADIR(ArrayName [, cFileSkeleton [, cAttribute]])
返值类型
    数值型
参数描述
ArrayName
指定数组名。如果数组不存在，Visual FoxPro 将自动创建此数组。如果数组存在，但其大小不足以包含所有信息，则 Visual FoxPro 自动增加数组大小，使得数组能容纳所有信息。如果数组超过了所需大小，Visual FoxPro 将截掉多余部分。如果数组存在，并且 ADIR（）函数由于没找到匹配文件而返回0，则数组保持不变。如果数组不存在，并且 ADIR（）函数返回零，则不创建数组。

下表说明了数组中每列的内容及其数据类型：
列             数组内容            数值类型
------------------------------------------------------------------
1              文件名              字符型
2              文件大小            数值型
3              文件日期            日期型
4              文件时间            字符型
5              文件属性            字符型
数组的最后一列包含匹配文件的文件属性。每个文件属性值由一个字母表示，一个文件可有多个属性。
下表说明每个字母表示的文件属性含义：
字母         属性
----------------------------------------------------------
A            档案文件可读写
H            隐藏文件R只读文件
S            系统文件
D            目录
CFileSkeleton
指定文件梗概，以便存储满足搜索条件的文件名或扩展名的文件信息。例如，条件可以是所有表、所有文本文件、所有文件名第一个字母为“A”的文件，等等。这些通配查询在 cFileSkeleton 中可以包含通配符 * 和 ?。其中问号代表单个字符，星号代表任意字符串。在文件梗概中，可在任意位置使用任意个数的通配符。可以指定驱动器和目录名，程序将在此驱动器和目录下搜索匹配文件。如果不指定驱动器和目录名，将把当前目录下的文件信息存入数组中。
Cattribute
    在返回内容中，指定包含子目录或嵌套文件夹、隐藏或系统文件、或者卷名。CAttribute 可以是 D、H 和 S 的任意组合。如果包含 D，除了返回匹配 cFileSkeleton 的文件名外，还将返回当前目录的子目录或当前文件夹的嵌套文件夹。如果包含 H，将返回与 cFileSkeleton 指定相匹配的隐藏文件信息。如果包含 S，将返回与 cFileSkeleton指定通配文件名相匹配的系统文件信息。如果 cFileSkeleton 为空字符串，仅返回子目录或嵌套文件夹名、隐藏或系统文件。CAttribute 参数中包含字符 V，将返回当前驱动器的卷名。如果 V 和 D、H 或 S 一起包含在数组中，则只返回卷名。卷名存入数组的第一个元素中，并截去数组的其余部分。
说明
对于每一个文件，ADIR（）将文件名、大小、日期、时间和属性信息存入数组。
示:
ADIR()创建了一个包含数据库信息的数组。另外还显示了数据库的名称。
CLOSE DATABASES
SET PATH TO (HOME(2) +'data')
?gnDbcnumber = ADIR(gaDatabase, '*.DBC')  && 创建数组
CLEAR
FOR nCount = 1 TO gnDbcnumber  && 循环数据库的编号
   ? gaDatabase(nCount,1)  && 显示数据库名称
ENDFOR
SET PATH TO HOME（） && 设置 Visual FoxPro 目录的路径
请参阅:
A, AELEMENT(), AFIELDS(), AINS(), ALEN(),ANETRESOURCES(), ASCAN(), ASORT(), ASUBSCRIPT(), DIMENSION, DIR 或 DIRECTORY