文件函数

目录操作

6 个函数

创建目录

File.mkdir(path: string): integer

创建文件夹;父级不存在时会一并创建。

参数1 项
序号名称类型参数说明
1 path 要创建的目录绝对路径。示例:/sdcard/测试目录
返回值返回值可以不接收
序号名称类型返回说明
1 status 操作状态。
  • 1:操作成功
  • 0:操作失败

目录存在

File.isDir(path: string): integer

判断路径是否指向一个已存在的文件夹。

参数1 项
序号名称类型参数说明
1 path 要判断的目录绝对路径。示例:/sdcard/测试目录
返回值返回值可以不接收
序号名称类型返回说明
1 isDirectory 路径是否为文件夹。
  • 1:目录存在
  • 0:目录不存在或不是文件夹

文件数量

File.files(directory: string): integer

统计目录下一层普通文件数量,不递归子目录。

参数1 项
序号名称类型参数说明
1 directory 要统计的目录绝对路径。示例:/sdcard/测试目录
返回值至少接收一个返回值
序号名称类型返回说明
1 fileCount 普通文件数量;失败时返回0。
  • 大于0:统计到内容
  • 0:没有内容或统计失败

文件夹数量

File.dirs(directory: string): integer

统计目录下一层文件夹数量,不递归子目录。

参数1 项
序号名称类型参数说明
1 directory 要统计的目录绝对路径。示例:/sdcard/测试目录
返回值至少接收一个返回值
序号名称类型返回说明
1 directoryCount 文件夹数量;失败时返回0。
  • 大于0:统计到内容
  • 0:没有内容或统计失败

指定后缀数量

File.suffix(directory: string, suffix: string): integer

统计目录下一层指定后缀的文件数量,不递归子目录。

参数2 项
序号名称类型参数说明
1 directory 要统计的目录绝对路径。示例:/sdcard/测试目录
2 suffix 要统计的文件后缀。示例:.txt 或 txt。
返回值至少接收一个返回值
序号名称类型返回说明
1 fileCount 匹配后缀的文件数量;失败时返回0。
  • 大于0:统计到内容
  • 0:没有内容或统计失败

目录统计

File.stats(directory: string): string

同时统计目录下一层的文件和文件夹数量。

参数1 项
序号名称类型参数说明
1 directory 要统计的目录绝对路径。示例:/sdcard/测试目录
返回值返回值可以不接收
序号名称类型返回说明
1 summary 文件与文件夹数量汇总文本。
  • 文件=3,文件夹=2:统计结果示例
  • 文件=0,文件夹=0:空目录或统计失败