โมดูล json คือโมดูล Starlark ของฟังก์ชันที่เกี่ยวข้องกับ JSON
สมาชิก
ถอดรหัส
unknown json.decode(x, default=unbound)ฟังก์ชัน decode มีพารามิเตอร์ตำแหน่งที่ต้องระบุ 1 รายการ ได้แก่ สตริง JSON โดยจะแสดงค่า Starlark ที่สตริงระบุ
"null","true"และ"false"ถูกแยกวิเคราะห์เป็นNone,TrueและFalse- ระบบจะแยกวิเคราะห์ตัวเลขเป็น int หรือเป็น float หากมีจุดทศนิยมหรือเลขชี้กำลัง แม้ว่า JSON จะไม่มีไวยากรณ์สำหรับค่าที่ไม่สิ้นสุด แต่อาจถอดรหัสค่าที่มีขนาดใหญ่มากเป็นแบบอินฟินิตี้
- ระบบจะแยกวิเคราะห์ออบเจ็กต์ JSON เป็นดิจิตอล Starlark ที่ไม่ได้ตรึงใหม่ หากสตริงคีย์เดียวกันปรากฏมากกว่า 1 ครั้งในออบเจ็กต์ ระบบจะเก็บค่าสุดท้ายสำหรับคีย์นั้นไว้
- อาร์เรย์ JSON จะแยกวิเคราะห์เป็นรายการ Starlark ใหม่ที่ไม่ได้ตรึง
x ไม่ใช่การเข้ารหัส JSON ที่ถูกต้องและระบุพารามิเตอร์ default ที่ไม่บังคับ (รวมถึงระบุเป็น None) ฟังก์ชันนี้จะแสดงผลค่า default
หาก x ไม่ได้เป็นการเข้ารหัส JSON ที่ถูกต้อง และไม่ได้ระบุพารามิเตอร์ default (ไม่บังคับ) ฟังก์ชันนี้จะดำเนินการไม่สำเร็จ
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
string;
required สตริง JSON ที่จะถอดรหัส |
default
|
ค่าเริ่มต้นคือ unboundหากระบุ ค่าที่จะส่งกลับเมื่อถอดรหัส x ไม่ได้
|
เข้ารหัส
string json.encode(x)
ฟังก์ชันการเข้ารหัสจะยอมรับอาร์กิวเมนต์ตำแหน่งที่จำเป็น 1 รายการ ซึ่งจะแปลงเป็น JSON ตามตัวพิมพ์เล็กและใหญ่ ดังนี้
- ไม่มี จริง และเท็จ จะถูกแปลงเป็น "null", "true" และ "false" ตามลำดับ
- ระบบจะเข้ารหัส int ไม่ว่าจะมีขนาดใหญ่เพียงใดก็ตามเป็นจำนวนเต็มทศนิยม ตัวถอดรหัสบางตัวอาจถอดรหัสจำนวนเต็มขนาดใหญ่มากไม่ได้
- จำนวนลอยตัวจะเข้ารหัสโดยใช้จุดทศนิยมหรือเลขชี้กำลัง หรือทั้งสองอย่าง แม้ว่าค่าตัวเลขจะเป็นจำนวนเต็มก็ตาม การโค้ดค่าทศนิยมที่ไม่แน่นอนเป็นข้อผิดพลาด
- ค่าสตริงจะเข้ารหัสเป็นสตริง JSON ที่แสดงค่า ระบบจะแทนที่ตัวแทนที่ไม่จับคู่แต่ละรายการด้วย U+FFFD
- ระบบจะเข้ารหัส Dict เป็นออบเจ็กต์ JSON ตามลําดับคีย์ ระบบจะแสดงข้อผิดพลาดหากคีย์ใดไม่ใช่สตริง
- รายการหรือทูเพลตจะเข้ารหัสเป็นอาร์เรย์ JSON
- ระบบจะเข้ารหัสค่าที่คล้ายกับโครงสร้างเป็นออบเจ็กต์ JSON ตามลําดับชื่อช่อง
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ต้องระบุ |
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')ฟังก์ชัน encode_indent จะมีค่าเท่ากับ
json.indent(json.encode(x), ...) ดูคำอธิบายพารามิเตอร์การจัดรูปแบบที่ indent
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ต้องระบุ |
prefix
|
string;
ค่าเริ่มต้นคือ '' |
indent
|
string;
default is '\t' |
เยื้อง
string json.indent(s, *, prefix='', indent='\t')ฟังก์ชัน indent จะแสดงผลรูปแบบที่มีการเยื้องของสตริงที่เข้ารหัส JSON ที่ถูกต้อง องค์ประกอบอาร์เรย์หรือช่องออบเจ็กต์แต่ละรายการจะปรากฏในบรรทัดใหม่ โดยเริ่มต้นด้วยสตริงคำนำหน้าตามด้วยสตริงการเยื้องอย่างน้อย 1 รายการตามระดับการฝัง ฟังก์ชันนี้ยอมรับพารามิเตอร์ตำแหน่งที่ต้องระบุ 1 รายการ ซึ่งเป็นสตริง JSON และพารามิเตอร์สตริงที่เป็นคีย์เวิร์ดเท่านั้น 2 รายการที่ไม่บังคับ ได้แก่ คำนำหน้าและการเยื้อง ซึ่งระบุคำนำหน้าของบรรทัดใหม่แต่ละรายการและหน่วยของการเยื้อง หากอินพุตไม่ถูกต้อง ฟังก์ชันอาจไม่ทำงานหรือแสดงผลลัพธ์ที่ไม่ถูกต้อง
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
s
|
string;
required |
prefix
|
string;
default is '' |
indent
|
string;
default is '\t' |