FTP目录列表 命令   操作系统支持:Windows   所属类别:HTTPFTP操作

返回FTP服务器上指定目录内的所有匹配文件和子目录信息。成功返回被找到的文件和子目录的数目,失败返回 0

语法:  整数型  FTP目录列表 (欲列出的文件,[欲列出文件的属性],[存放文件名的数组变量],[存放文件属性的数组变量],[存放文件尺寸的数组变量],[存放文件时间的数组变量])

参数名

描 述

欲列出的文件

必需的;文本型。可以包含路径,可以使用多字符 (*) 和单字符 (?) 通配符来指定多重文件及目录。

欲列出文件的属性

可选的;整数型。参数值可以为以下常量值或其和: 1#只读文件; 2#隐藏文件; 4#系统文件; 16#子目录; 32#存档文件 。通过将这些常量值加起来可以一次设置多个文件属性。如果省略本参数,默认为搜寻所有子目录和文件。

存放文件名的数组变量

可选的;文本型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件和子目录名称。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。

存放文件属性的数组变量

可选的;整数型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的属性,并与文件名数组成员一一对应。此属性值由以下常量或其和构成: 1#只读文件; 2#隐藏文件; 4#系统文件; 16#子目录;32#存档文件 。要判断是否设置了某个属性,在返回值与想要得知的属性值之间使用位与命令进行比较。如果所得的结果不为零,则表示设置了这个属性值。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。

存放文件尺寸的数组变量

可选的;整数型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的尺寸,并与文件名数组成员一一对应。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。

存放文件时间的数组变量

可选的;日期时间型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的最后修改时间,并与文件名数组成员一一对应。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。

 

例程

说明

通过“FTP目录列表”命令取出所有文件(包括目录)的信息,分别存放在对应的变量中。

参考:例程1