# aardio 标准库 JSON 解析规范

发布日期：2020-12-27

参考: JSON 标准库

JSON 字符串化时完全符合 JSON 官方标准( https://json.org/json-zh.html )。 JSON 解析时完全支持 JSON，JSONP，并使用宽松的原则兼容 JSON5，兼容部分类 YAML 语法。

aardio 以“宽进严出、简洁高效”为基本原则。 解析时规则尽可能宽松容错，生成 JSON 字符串则严格遵守标准 JSON 规则。

aardio 标准库在遵守 JSON 标准协议的前提下为 JSON 解析器扩展了以下功能：

1. 可省略和替换的格式标记

• 允许省略根节点对象外部的 {}
• 允许使用分号、空格、换行替代元素分隔符,
• 允许使用等号、空格、换行替代对象键值分隔符:
• 允许省略字符串外部的引号。

2. 根节点

• JSON 节点可以是任意数据类型，单个字符串、数值都可以解析并返回值。
• 根节点是对象时，可以省略外层的花括号。
• 根节点是字符串时不可省略引号。
• 根节点解析成功的 JSON 后面如果还有多余的文本时忽略。
• 根节点兼容 JSONP 格式

3. 字符串

字符串置于双引号中时支持 JSON 转义符。 JSON 字符串置于单引号内不支持 JSON 转义符，使用 2 个单引号表示原始单引号。 在引号内部时字符串可以换行。

要特别注意 aardio 语法规则正好跟上面相反： aardio 代码里单引号内是“编译时转义字符串”（反斜杆识别为转义符，属于 “JavaScript 风格字符串” ），而双引号内是原样字符串（编译时将反斜杆作为普通字符，并以两个双引号表示原始双引号,属于 “BASIC/SQL 风格” 字符串）。

JSON 字符串可省略首尾引号，此时不支持 JSON 转义符，遇到回车或换行、逗号、中括号、大括号时字符串结束解析。字符串作为对象键名如果省略引号时不能包含空白字符、换行或键值分隔符。

4. 注释

1、支持 // 或 # 引导的单行注释 2、支持包含于 /*......*/ 内的块注释（注意这里按js规则不匹配首尾星号数目）。

5. 数值

数值支持 16 进制

6. null值

可以使用 null,undefined,~ 表示 null 值。

7. 日期时间

可使用 ISO 8601 格式表示日期时间，合法的格式如下：

2021-01-1 2021-02-1T15:02:31+08:00 2021-02-1T15:02:31+08:00Z

数字前可不用补 0，但日期分隔符必须使用短横线，时间分隔符必须使用冒号， 尾部时区不可以包含空白字符，但可以包含 +-: 等字符以及数字、字母。

日期时间不用包含在引号内，引号内会被误别为字符串，示例：

{"time":2021-01-1,"string":"2021-01-1" }

Markdown 格式