# fsys.latest 库模块帮助文档

## fsys 成员列表 <a id="fsys" href="#fsys">&#x23;</a>

### fsys.latest <a id="fsys.latest" href="#fsys.latest">&#x23;</a>
获取最新文件路径。  
这是一个独立的标准库，需要用 import 语句导入才能使用。  
执行成功时这个函数返回 3 个值：  
- 返回值 1 为最新文件的完整路径  
- 返回值 2 为当前找到文件的目录路径。  
- 返回值 3 为数组，数组元素格式为 `[文件或目录名,时间]`（时间为 time 对象），  
包含符合搜索条件的全部文件或目录名称与文件时间，  
已按写入时间排序（新的靠前）。

### fsys.latest(目录,子目录通配符,子目录或文件通配符,...) <a id="fsys.latest" href="#fsys.latest">&#x23;</a>
逐级搜索目录下符合条件的目最后一个被修改过的录文件。  
参数 @1 支持环境变量（忽略大小写），例如 `%LocalAppData%\Programs\`  
如果参数 @1 为 null 、空字符串、无效目录、空目录则返回 null 值。  

参数 @2 （默认为 `*.*）开始的全部可选参数  
都支持通配符，多个通配符可以`|`分隔或指定字符串数组。  

函数在参数 @1 指定的目录下搜索参数 @2，  
如果找到子目录则继续在找到的子目录下搜索参数 @3，  
上述规则逐级向下搜索后续参数指定的子级目录。  
直到找到并返回与最后一个字参数相符的最新目录或文件。  
任何一个参数不匹配则返回 null 。

### fsys.latest(目录,文件通配符,搜索所有下级目录) <a id="fsys.latest" href="#fsys.latest">&#x23;</a>
搜索目录下符合条件的文件中最后一个被修改过的目录或文件路径。  
参数 @1 支持环境变量（忽略大小写），例如 `%LocalAppData%\Programs\`  
如果参数 @1 为 null 、空字符串、无效目录、空目录则返回 null 值。  
参数 @2 支持通配符，默认为 `*.*`,多个通配符可以`|`分隔或指定字符串数组。  
参数 @3 可选用布尔值指定是否搜索所有下级子目录，默认为 false
