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. }