json库
python 原始类型与 json 类型的转化对照表:
| Python | JSON |
|---|---|
| dict | object |
| list(, tuple) | array |
| unicode(, str) | string |
| int(, long) | number (int) |
| float | number (real) |
| True | true |
| False | false |
| None | null |
json.dumps()
将 Python 对象编码成 JSON 字符串.
json.dumps(obj, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw)
| 参数 | 说明 |
|---|---|
| skipkeys | 如果为真，则"字典"键不是基本类型(str, int, float, bool, None)将被跳过而不是提出“类型错误”。 |
| ensure_ascii | 如果为假, 则返回值可以包含非 ASCII字符(如果它们出现在“obj”中包含的字符串中). 否则, 所有此类字符在 JSON 字符串中转义. |
| check_circular | 如果为假，则跳过对于容器类型的循环引用检查并且循环引用会导致“溢出错误”（或更糟）。 |
| allow_nan | 如果为假, 那么在严格遵守 JSON 规范的情况下, 对于python序列化对象超出范围的浮点值(nan, inf, -inf)将是“值错误”, 而不是使用 JavaScript 等效项(NaN, Infinity, -Infinity). |
| cls | 要使用自定义的"JSONEncoder"子类(例如, 重写''.default()''方法以序列化其他类型), 请使用"cls"kwarg指定它; 否则, 将使用JSON 编码器. |
| indent | 如果是非负整数, 则 JSON 数组元素和对象成员将使用该缩进级别进行美观打印. 缩进级别 0 将仅插入换行符. “无”是最紧凑的表示形式. |
| separators | 如果指定, 分隔符应为(item_separator，key_separator)元组. 默认值为(', ', ': '). 要获得最紧凑的 JSON 表示形式，您应该指定(',', ':')以消除空格。 |
| default | "default(obj)"是一个函数, 应该返回 obj 的可序列化版本或引发类型错误. 默认值只是引发类型错误. |
| sort_keys | 如果为真, 则字典的输出将按键排序. |
import json
data = [{'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5}]
data2 = json.dumps(data, sort_keys=True, indent=4, separators=(',', ': '))
print(data2)
#'[
# {
# "a": 1,
# "b": 2,
# "c": 3,
# "d": 4,
# "e": 5
# }
#]'
# JSON 字符串
json.loads()
将已编码的 JSON 字符串解码为 Python 对象.
json.loads(s, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
| 参数 | 说明 |
|---|---|
| s | 将"s"（包含 JSON 文档的"str"、"bytes"或"bytearray"实例）反序列化为 Python 对象 |
| cls | 要使用自定义的" JSON 解码器"子类, 请使用"cls" kwarg指定它; 否则, 将使用" JSON 解码器" |
| object_hook | "object_hook"是一个可选函数, 将使用任何对象文本解码(字典)的结果进行调用. 用(object_hook)的返回值代替字典. 此功能可用于实现自定义解码器(例如 JSON-RPC 类提示) |
| parse_float | "parse_float"(如果指定)将与要解码的每个 JSON 浮点数的字符串一起调用. 默认情况下, 这等效于浮点数(num_str). 这可用于将其他数据类型或解析器用于 JSON 浮点数 |
| parse_int | "parse_int"(如果指定)将与要解码的每个 JSON 整型的字符串一起调用. 默认情况下, 这等效于 int(num_str). 这可用于对 JSON 整数(例如浮点数)使用其他数据类型或解析器 |
| parse_constant | "parse_constant"(如果指定)将使用以下字符串之一调用: -Infinity, Infinity, NaN. 这可用于在遇到无效的 JSON 编号时引发异常 |
| object_pairs_hook | "object_pairs_hook"是一个可选函数, 它将使用有序的对列表解码的任何对象文本的结果进行调用. 将使用"object_pairs_hook"的返回值代替"字典". 此功能可用于实现自定义解码器. 如果还定义了"object_hook", 则"object_pairs_hook"优先 |
data3 = json.loads(data2)
print(data3)
# [{'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5}]
# 列表类型
json.dump()
向文件写入对应 JSON 格式的 python 对象.
json.dump(obj, fp, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw)
with open('data.json', 'w') as f:
json.dump(data, f, indent=4)
json.load()
读取 JSON 数据.
json.load(fp, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
with open('data.json', 'r') as f:
data = json.load(f)
print(data)
# [{'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5}]