JSON

JSON mô-đun là một mô-đun Starlark gồm các hàm liên quan đến JSON.

Hội viên

• giải mã
• mã hoá
• encode_indent
• thụt lề

giải mã

unknown json.decode(x)

Hàm giải mã chấp nhận một tham số vị trí là một chuỗi JSON. Phương thức 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 thành Không có, Đúng và Sai.
• Số được phân tích cú pháp dưới dạng số nguyên hoặc dưới dạng số thực nếu số đó 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ô hạn.
• đối tượng JSON được phân tích cú pháp dưới dạng một lệnh chính của Starlark mới chưa được cố định. Khoá phải là chuỗi duy nhất.
• một mảng JSON được phân tích cú pháp dưới dạng danh sách Starlark mới chưa được cố định.

Không giải mã được nếu x không phải là phương thức mã hoá JSON hợp lệ.

Tham số

Thông số	Mô tả
x	bắt buộc

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 trường hợp:

• Không có, "Đúng và Sai" lần lượt được chuyển đổi thành "null", "true" và "false".
• Số nguyên, bất kể lớn như thế nào, vẫn đượ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 các số nguyên quá lớn.
• Số thực được mã hoá bằng dấu thập phân/số mũ hoặc cả hai, ngay cả khi giá trị số của số thực là số nguyên. Đây là một lỗi khi mã hoá một giá trị dấu phẩy động không hữu hạn.
• Giá trị chuỗi được mã hoá dưới dạng giá trị cố định kiểu chuỗi JSON biểu thị giá trị đó. Mỗi giá trị thay thế chưa ghép nối sẽ được thay thế bằng U+FFFD.
• Một lệnh chính tả được mã hoá dưới dạng đối tượng JSON theo thứ tự khoá. Sẽ xảy ra lỗi nếu khoá nào không phải là một chuỗ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.

Kiểu do ứng dụng xác định có thể xác định phương thức mã hoá JSON riêng. Việc mã hoá bất kỳ giá trị nào khác đều dẫn đến lỗi.

Tham số

Thông số	Mô tả
x	bắt buộc

encode_indent

string json.encode_indent(x, *, prefix='', indent='\t')

Hàm encrypted_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ố

Thông số	Mô tả
x	bắt buộc
prefix	mặc định = ''
indent	mặc định = '\t'

thụt lề

string json.indent(s, *, prefix='', indent='\t')

Hàm thụt lề trả về dạng thụt đầu dòng 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ố, theo sau là một hoặc nhiều bản sao của chuỗi thụt lề, tuỳ theo độ sâu lồng của chuỗi đó. Hàm này chấp nhận một tham số vị trí bắt buộc là chuỗi JSON và hai tham số chuỗi chỉ dành cho từ khoá không bắt buộc là 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 giá trị nhập vào không hợp lệ, hàm có thể bị lỗi hoặc trả về giá trị đầu ra không hợp lệ.

Tham số

Thông số	Mô tả
s	bắt buộc
prefix	mặc định = ''
indent	mặc định = '\t'