模块 json 是包含 JSON 相关函数的 Starlark 模块。
成员
解码
unknown json.decode(x, default=unbound)
- 系统会将
"null"
、"true"
和"false"
解析为None
、True
和False
。 - 系统会将数字解析为 int,如果数字包含小数点或指数,则解析为浮点数。虽然 JSON 没有非有限值的语法,但非常大的值可能会解码为无穷大。
- JSON 对象会解析为新的未冻结 Starlark 字典。如果对象中出现了相同的键字符串多次,则系统会保留该键的最后一个值。
- JSON 数组会解析为新的未冻结 Starlark 列表。
x
不是有效的 JSON 编码,并且指定了可选的 default
参数(包括指定为 None
),则此函数会返回 default
值。如果 x
不是有效的 JSON 编码,并且未指定可选的 default
参数,则此函数会失败。
参数
参数 | 说明 |
---|---|
x
|
string;
必需 要解码的 JSON 字符串。 |
default
|
默认值为 unbound 如果指定,则表示在无法解码 x 时返回的值。
|
encode
string json.encode(x)
encode 函数接受一个必需的位置参数,并根据情况将其转换为 JSON:
- None、True 和 False 分别转换为“null”“true”和“false”。
- 无论大小,int 都会编码为十进制整数。某些解码器可能无法解码非常大的整数。
- 浮点数使用小数点或指数(或两者兼有)进行编码,即使其数值是整数也是如此。编码无限浮点值是错误的。
- 字符串值会编码为表示该值的 JSON 字符串字面量。每个未配对的代理字符都会替换为 U+FFFD。
- 字典会编码为按键值顺序的 JSON 对象。如果任何键不是字符串,则会出错。
- 列表或元组会编码为 JSON 数组。
- 类似结构体的值会编码为 JSON 对象,并按字段名称顺序排列。
参数
参数 | 说明 |
---|---|
x
|
必填 |
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')
json.indent(json.encode(x), ...)
。如需了解格式设置参数的说明,请参阅 indent
。
参数
缩进
string json.indent(s, *, prefix='', indent='\t')