2024年4月1日发(作者：)
ADIR( ) 函数
将文件信息存放到数组中，然后返回文件个数。
语法
ADIR(ArrayName [, cFileSkeleton [, cAttribute [, cCreatorType]]])
参数
ArrayName
指定数组名。如果数组不存在，Visual FoxPro 将自动创建此数组。如果数组存
在，但其大小不足以包含所有信息，则 Visual FoxPro 自动增加数组大小，使得
数组能容纳所有信息。如果数组超过了所需大小，Visual FoxPro 将截掉多余部
分。如果数组存在，并且 ADIR( ) 函数由于没找到匹配文件而返回 0，则数组
保持不变。如果数组不存在，并且 ADIR( ) 函数返回零，则不创建数组。
下表说明了数组中每列的内容及其数据类型：
列 数组内容 数据类型
1 文件名 字符型
2 文件大小 数值型
3 档最后修改日期 日期型
4 文件最后修改时间 字符型
5 文件属性 字符型
数组的最后一列包含匹配档的文件属性。每个文件属性值由一个字母表示，一个
文件可有多个属性。下表说明每个字母表示的文件属性含义：
字母 属性
A 档案档 一 可擦写
H 隐藏文件
R 只读文件
S 系统文件
D 目录或文件夹
cFileSkeleton
指定档梗概，以便存储满足搜索条件的文件名或扩展名的文件信息。例如，条件
可以是所有表、所有文本文件、所有文件名第一个字母为“A”的檔，等等。这
些通配查询在 cFileSkeleton 中可以包含通配符 * 和 ?。其中问号代表单个字
符，星号代表任意字符串。在文件梗概中，可在任意位置使用任意个数的通配符。
在 Visual FoxPro、FoxPro for Windows 和 FoxPro for MS-DOS 中，可以指定驱
动器和目录名，程序将在此驱动器和目录下搜索匹配文件。如果不指定驱动器和
目录名，将把当前目录下的文件信息存入数组中。
在 FoxPro for Macintosh 中，可以搜索匹配文件名的卷和文件夹。如果不指定卷
和文件夹，
FoxPro for Macintosh 将当前文件夹中的文件信息存入数组中。
cAttribute
指定在返回内容中包含子目录或嵌套文件夹、隐藏或系统文件、或者卷名。
cAttribute 可以是 D、H 和 S 的任意组合。如果包含 D，除了返回匹配
cFileSkeleton 的文件名外，还将返回当前目录的子目录或当前文件夹的嵌套文件
夹。如果包含 H，将返回与 cFileSkeleton 指定相匹配的隐藏文件信息。如果包
含 S，将返回与 cFileSkeleton 指定通配文件名相匹配的系统文件信息。
如果 cFileSkeleton 为空字符串，仅返回子目录或嵌套文件夹名、隐藏或系统文
件。
cAttribute 参数中包含字符 V，将返回当前驱动器的卷名。如果 V 和 D、H 或
S 一起包含在数组中，则只返回卷名。卷名存入数组的第一个元素中，并截去数
组的其余部分。
cCreatorType
仅用于 FoxPro for Macintosh。
用指定的创建程序类型指定文件。如果参数 cFileSkeleton 为空字符串，则仅有
匹配指定创建程序类型 cCreatorType 的文件放置到数组中去。如果在参数
cfileSkeleton 中有一个档梗概，则匹配档梗概且具有 cCreatorType 指定的创建
程序类型的文件被放入数组中。
若要获取 FoxPro for Macintosh 所有的档扩展名以及相关的创建程序类型，请参
阅档扩展名与文件类型。
返回值类型
数值型
说明
对于每一个档，ADIR( ) 将文件名、大小、日期、时间和属性信息存入数组。
Visual FoxPro磁盘_目录_文件函数
ADIR() 将文件信息存放到数组中，然后返回文件个数。 <二楼>
CURDIR() 返回当前目录或文件夹。
DEFAULTEXT() 如果一个档没有扩展名，则返回一个带新扩展名的文件名。
DIRECTORY() 若在磁盘上存在指定的目录，返回真 (.T.)。
DISPLAYPATH() 为显示而截去长路径名到指定长度。
DRIVETYPE() 返回指定驱动器的类型。
FDATE() 返回檔最近一次修改的日期或日期时间。
FILE() 如果在磁盘上找到指定的文件，则返回“真”(.T.)。
FILETOSTR() 将一个档的内容返回为一个字符串。
FORCEEXT() 返回一个字符串，使用新的扩展名替换旧的扩展名
FORCEPATH() 返回一个文件名，使用新路径名代替旧文件名
FTIME() 返回最近一次修改档的时间。
FULLPATH() 返回指定文件的路径或相对于另一文件的路径。
发布评论