Mô-đun json là một mô-đun Starlark gồm các hàm liên quan đến JSON.
Hội viên
giải mã
unknown json.decode(x, default=unbound)
Hàm giải mã có một tham số vị trí bắt buộc: một chuỗi JSON.
Hàm này trả về giá trị Starlark mà chuỗi biểu thị.
"null", "true" và "false" được phân tích cú pháp dưới dạng None, True và False.
- Các số được phân tích cú pháp dưới dạng số nguyên hoặc số thực nếu chứa dấu thập phân hoặc số mũ. Mặc dù JSON không có cú pháp cho các giá trị không hữu hạn, nhưng các giá trị rất lớn có thể được giải mã dưới dạng vô cực.
- một đối tượng JSON được phân tích cú pháp dưới dạng một từ điển Starlark mới không đóng băng. Nếu chuỗi khoá giống nhau xuất hiện nhiều lần trong đối tượng, thì giá trị cuối cùng cho khoá sẽ được giữ lại.
- một mảng JSON được phân tích cú pháp dưới dạng danh sách Starlark mới không đóng băng.
Nếu
x không phải là một mã hoá JSON hợp lệ và tham số
default không bắt buộc được chỉ định (bao gồm cả tham số được chỉ định là
None), thì hàm này sẽ trả về giá trị
default.
Nếu
x không phải là một mã hoá JSON hợp lệ và tham số
default không bắt buộc
không được chỉ định, thì hàm này sẽ không thành công.
Tham số
| Tham số |
Mô tả |
x
|
chuỗi;
bắt buộc
Chuỗi JSON cần giải mã.
|
default
|
giá trị mặc định là unbound
Nếu được chỉ định, giá trị sẽ trả về khi không thể giải mã x.
|
mã hoá
string json.encode(x)
Hàm mã hoá chấp nhận một đối số vị trí bắt buộc, đối số này sẽ chuyển đổi thành JSON theo các trường hợp:
- None, True và False được chuyển đổi thành "null", "true" và "false".
- Số nguyên, dù lớn đến đâu, cũng được mã hoá dưới dạng số nguyên thập phân. Một số bộ giải mã có thể không giải mã được số nguyên rất lớn.
- Số thực được mã hoá bằng dấu thập phân hoặc số mũ hoặc cả hai, ngay cả khi giá trị số của số thực là số nguyên. Việc mã hoá giá trị dấu phẩy động không hữu hạn sẽ gây ra lỗi.
- Giá trị chuỗi được mã hoá dưới dạng ký tự chuỗi JSON biểu thị giá trị. Mỗi surrogate không ghép cặp được thay thế bằng U+FFFD.
- Từ điển được mã hoá dưới dạng đối tượng JSON, theo thứ tự từ vựng của khoá. Nếu bất kỳ khoá nào không phải là chuỗi, thì đó là lỗi.
- Danh sách hoặc bộ dữ liệu được mã hoá dưới dạng mảng JSON.
- Giá trị giống cấu trúc được mã hoá dưới dạng đối tượng JSON, theo thứ tự tên trường.
Loại do ứng dụng xác định có thể xác định mã hoá JSON riêng.
Việc mã hoá bất kỳ giá trị nào khác sẽ tạo ra lỗi.
Tham số
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')
Hàm encode_indent tương đương với
json.indent(json.encode(x), ...). Hãy xem
indent để biết nội dung mô tả về các tham số định dạng.
Tham số
| Tham số |
Mô tả |
x
|
bắt buộc
|
prefix
|
chuỗi;
giá trị mặc định là ''
|
indent
|
chuỗi;
giá trị mặc định là '\t'
|
thụt lề
string json.indent(s, *, prefix='', indent='\t')
Hàm thụt lề trả về dạng thụt lề của một chuỗi được mã hoá JSON hợp lệ.
Mỗi phần tử mảng hoặc trường đối tượng xuất hiện trên một dòng mới, bắt đầu bằng chuỗi tiền tố, tiếp theo là một hoặc nhiều bản sao của chuỗi thụt lề, tuỳ theo độ sâu lồng nhau.
Hàm này chấp nhận một tham số vị trí bắt buộc (chuỗi JSON) và hai tham số chuỗi chỉ từ khoá không bắt buộc (tiền tố và thụt lề) chỉ định tiền tố của mỗi dòng mới và đơn vị thụt lề.
Nếu đầu vào không hợp lệ, hàm có thể không thành công hoặc trả về đầu ra không hợp lệ.
Tham số
| Tham số |
Mô tả |
s
|
chuỗi;
bắt buộc
|
prefix
|
chuỗi;
giá trị mặc định là ''
|
indent
|
chuỗi;
giá trị mặc định là '\t'
|
