FTP目录列表 命令 操作系统支持:Windows 所属类别:HTTP及FTP操作
返回FTP服务器上指定目录内的所有匹配文件和子目录信息。成功返回被找到的文件和子目录的数目,失败返回 0 。
语法: 整数型 FTP目录列表 (欲列出的文件,[欲列出文件的属性],[存放文件名的数组变量],[存放文件属性的数组变量],[存放文件尺寸的数组变量],[存放文件时间的数组变量])
参数名 |
描 述 |
欲列出的文件 |
必需的;文本型。可以包含路径,可以使用多字符 (*) 和单字符 (?) 通配符来指定多重文件及目录。 |
欲列出文件的属性 |
可选的;整数型。参数值可以为以下常量值或其和: 1、#只读文件; 2、#隐藏文件; 4、#系统文件; 16、#子目录; 32、#存档文件 。通过将这些常量值加起来可以一次设置多个文件属性。如果省略本参数,默认为搜寻所有子目录和文件。 |
存放文件名的数组变量 |
可选的;文本型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件和子目录名称。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。 |
存放文件属性的数组变量 |
可选的;整数型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的属性,并与文件名数组成员一一对应。此属性值由以下常量或其和构成: 1、#只读文件; 2、#隐藏文件; 4、#系统文件; 16、#子目录;32、#存档文件 。要判断是否设置了某个属性,在返回值与想要得知的属性值之间使用“位与”命令进行比较。如果所得的结果不为零,则表示设置了这个属性值。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。 |
存放文件尺寸的数组变量 |
可选的;整数型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的尺寸,并与文件名数组成员一一对应。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。 |
存放文件时间的数组变量 |
可选的;日期时间型,参数数据只能提供变量数组。在命令执行完毕后,本变量数组内被顺序填入所找到的匹配文件的最后修改时间,并与文件名数组成员一一对应。变量数组内原有数据被全部销毁,变量数组的维数被自动调整为所找到的文件数目。如果本参数被省略,默认值为空。 |
例程
说明
通过“FTP目录列表”命令取出所有文件(包括目录)的信息,分别存放在对应的变量中。
参考:例程1