list()

语法

File.list( [options], [filter] )

类别

File

描述

列出当前目录的文件

参数

参数名参数类型描述是否必填
optionsJSON可选参数否
filterJSON筛选条件，不指定筛选条件默认显示全部内容否

options 参数详细说明如下：

属性值类型描述是否必填
detailboolean是否显示详细内容否
pathnamestring文件路径否

参数 filter 支持对结果中的某些字段进行 and 、 or 、not 和精确匹配计算，对结果集进行筛选。

返回值

返回指定目录下的文件信息。

错误

如果出错则抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。关于错误处理可以参考常见错误处理指南。

常见错误可参考错误码。

示例

  • 列出当前目录的文件；
  1. > File.list( { detail: true, pathname: "/opt/sequoiadb" } )
  2. {
  3.   "name": "file1.txt",
  4.   "size": "20480",
  5.   "mode": "drwxr-xr-x",
  6.   "user": "root",
  7.   "group": "root",
  8.   "lasttime": "6月 11 11:58"
  9. }
  10. {
  11.   "name": "file2.txt",
  12.   "size": "20480",
  13.   "mode": "drwxr-xr-x",
  14.   "user": "root",
  15.   "group": "root",
  16.   "lasttime": "6月 12 12:58"
  17. }
  18. {
  19.   "name": "file3.txt",
  20.   "size": "20480",
  21.   "mode": "drwxr-xr-x",
  22.   "user": "root",
  23.   "group": "root",
  24.   "lasttime": "6月 13 13:58"
  25. }
  • 列出当前目录的文件后，对结果进行筛选。
  1. > File.list( { detail: true, pathname: "/opt/sequoiadb" }, { $and: [ { name: "file1" }, { size: "20480" } ] } )
  2. {
  3.   "name": "file1.txt",
  4.   "size": "20480",
  5.   "mode": "drwxr-xr-x",
  6.   "user": "root",
  7.   "group": "root",
  8.   "lasttime": "6月 13 13:58"
  9. }