find()

语法

File.find( <options>, [filter] )

类别

File

描述

查找文件

参数

参数名参数类型默认值描述是否必填
optionsJSON—-查找模式和查找内容
filterJSON默认显示全部内容筛选条件

options 参数详细说明如下:

属性值类型描述是否必填
modechar{ mode: 'n' } 表示根据文件名( filename )查找文件{ mode: 'u' } 表示根据用户名( username )查找文件{ mode: 'g' } 表示根据用户组名( groupname )查找文件{ mode: 'p' } 表示根据权限( perssion )查找文件
pathnamestring指定查找的文件路径,默认为当前目录
valuestring查找的内容

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

返回值

返回查找内容。

错误

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

常见错误可参考错误码

示例

  • 查找文件;
  1. > File.find( { mode: 'n', value: "file.txt", pathname: "/opt" } )
  2. {
  3. "pathname": "/opt/sequoiadb1/file.txt"
  4. }
  5. {
  6. "pathname": "/opt/sequoiadb2/file.txt"
  7. }
  8. {
  9. "pathname": "/opt/sequoiadb3/file.txt"
  10. }
  • 查找文件后,对结果进行筛选。
  1. > File.find( { mode: 'n', value: "file.txt", pathname: "/opt" }, { $or: [ { pathname: "/opt/sequoiadb1/file.txt" }, { pathname: "/opt/sequoiadb2/file.txt" } ] } )
  2. {
  3. "pathname": "/opt/sequoiadb1/file.txt"
  4. }
  5. {
  6. "pathname": "/opt/sequoiadb2/file.txt"
  7. }