aardio 开发环境使用 .aar 文件创建目录索引。
例如文档、范例、工具等目录以及其子目录下基本都有一个 .aar 索引文件。
aardio 本地文档浏览器与在线文档都支持自动转换 .aar 文件为网页格式。 为避免误读服务器上被转换为 HTML 的 .aar 文件,fsys.aar.load 在读取 .aar 文件时,如果发现第一个非空白字符是 .aar 文件是以 .aar 中以 如果一个目录名必须以 可使用 string.table 函数将 .aar 文件内容转换为表对象。
但 string.table 仅有解析功能,返回的表仅包含名值对,而 fsys.aar 可解码、编码 .aar 文件,并且能保留文件排序与获取完整文件路径。
说明
< 则直接返回 null 。行为单位的字符串属性表。
每一行的=符号之前是显示名称,=符号之后是文件或目录路径。
如果路径指定了 .aar 文件则会自动转换为 .aar 所在的目录路径。. + 英文字母 结尾的文件名被视为文件,反之则被视为目录。
. + 英文字母结尾,则应当在后面添加斜杆或反斜杆显式声明为目录。
例如 Python 3.x=Python 3.x/ 。
aardio 开发环境 .aar 索引文件解析器。
查找 *.aar 文件中的错误
查找单个 *.aar 文件中的错误。
无错返回 null,有错返回数组。
每个错误的项目也是一个[显示名称,错误路径]格式的子数组。
返回空数组表示参数指定了错误的 aar 文件路径。
参数 @1 指定目录,省略则默认为 ~/。
批量查找目录下所有 *.aar 索引文件中的错误。
每个错误的项目是一个{aar=aarFilePath,invalidPaths=[[显示名称,错误路径],...]}格式的子数组。
返回空数组(空数组为 Truthy 值)表示参数指定了错误的目录路径。
没有任何错误返回 null。
加载并解析参数 @path 指定路径的 .aar 文件,后缀名必须小写。
文件不存在或文件内容第一个非空白字符是<则返回 null 值。
解析成功并返回 2 个值:文件数组,目录数组。
数组都是由显示名称组成的字符串数组。
数组同时包含显示名称映射到文件名目录的名值对成员。
参数 @isFullPath 指定是否转换为绝对路径(默认为 true),
~,//,\\ 开头的路径不转换,.aar 路径会转换为目录路径。
@isFullPath 为 false 则不作任何转换。
编码并保存 .aar 文件,成功返回 true 。
参数 @path 指定 .aar 文件路径。
files,dirs 分别为文件数组、目录数组。
files,dirs 的格式必须与 load 方法的返回格式相同。
使用 load 方法加载并解析 .aar 文件,
并将返回的文件与目录索引转换为 Markdown 格式的链接列表。
保持原路径值,不会转换为完整路径,不会将 .aar 转换为目录。
返回字符串值