โครงสร้าง

รายงานปัญหา ดูแหล่งที่มา

ออบเจ็กต์ทั่วไปที่มีช่อง

เมื่อสร้างโครงสร้างแล้ว คุณจะกำหนดช่องโครงสร้างใหม่ไม่ได้ โครงสร้าง 2 แบบมีค่าเท่ากันหากมีช่องเหมือนกันและในกรณีที่ค่าของช่องที่เกี่ยวข้องเท่ากัน

สมาชิก

• โครงสร้าง
• to_json
• to_proto

โครงสร้าง

struct struct(**kwargs)

สร้างโครงสร้างที่เปลี่ยนแปลงไม่ได้โดยใช้อาร์กิวเมนต์คีย์เวิร์ดเป็นแอตทริบิวต์ ซึ่งใช้ในการจัดกลุ่มค่าหลายค่าเข้าด้วยกัน ตัวอย่าง

s = struct(x = 2, y = 3)
return s.x + getattr(s, "y")  # returns 5

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
kwargs	ค่าเริ่มต้นคือ {} พจนานุกรมของอาร์กิวเมนต์

to_json

string struct.to_json()

เลิกใช้งานแล้ว API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าพึ่งพาสิ่งนี้ ถูกปิดใช้กับ ---incompatible_struct_has_no_methods ใช้แฟล็กนี้เพื่อยืนยันว่าโค้ดเข้ากันได้กับการนําออกที่กำลังจะเกิดขึ้น
สร้างสตริง JSON จากพารามิเตอร์ Struct เมธอดนี้จะใช้งานได้ก็ต่อเมื่อองค์ประกอบ Struct ทั้งหมด (แสดงซ้ำๆ) เป็นสตริง, ints, บูลีน, Struct อื่นๆ รายการประเภทเหล่านี้ หรือพจนานุกรมที่มีคีย์สตริงและค่าประเภทดังกล่าว เครื่องหมายคำพูดและบรรทัดใหม่ในสตริงจะใช้อักขระหลีก ตัวอย่าง:

struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}

เลิกใช้งาน: ใช้ json.encode(x) หรือ json.encode_indent(x) แทน ซึ่งใช้ได้กับค่าอื่นๆ ที่ไม่ใช่ Struct และไม่ทำให้เนมสเปซของช่อง Struct เสียหาย

to_proto

string struct.to_proto()

เลิกใช้งานแล้ว API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าพึ่งพาสิ่งนี้ ถูกปิดใช้กับ ---incompatible_struct_has_no_methods ใช้แฟล็กนี้เพื่อยืนยันว่าโค้ดเข้ากันได้กับการนําออกที่กำลังจะเกิดขึ้น
สร้าง SMS จากพารามิเตอร์ Struct วิธีการนี้จะใช้งานได้ก็ต่อเมื่อองค์ประกอบ Struct ทั้งหมด (แบบเรียกซ้ำ) เป็นสตริง, ints, บูลีน, Struct หรือคำสั่งอื่นๆ หรือรายการประเภทเหล่านี้ เครื่องหมายคำพูดและบรรทัดใหม่ในสตริงจะใช้อักขระหลีก คีย์โครงสร้างจะทำซ้ำตามลำดับที่จัดเรียง ตัวอย่าง:

struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

เลิกใช้งาน: ใช้ proto.encode_text(x) แทน