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