giao thức

Báo cáo vấn đề Xem nguồn Hằng đêm · 7,3 · 7.2 · 7.1 · 7 · 6,5

Một mô-đun để xử lý thông báo giao thức.

Hội viên

encode_text

string proto.encode_text(x)

Trả về mã hoá của đối số cấu trúc dưới dạng thông báo giao thức định dạng văn bản. Cấu trúc dữ liệu phải bao gồm đệ quy bao gồm các chuỗi, số nguyên, số thực có độ chính xác đơn hoặc số bools, hoặc cấu trúc, chuỗi và lệnh chính tả thuộc các loại này.

Một cấu trúc được chuyển đổi thành một thông báo. Các trường được điền theo thứ tự tên. Mỗi trường cấu trúc có giá trị là Nothing sẽ bị bỏ qua.

Một chuỗi (chẳng hạn như một danh sách hoặc một bộ dữ liệu) sẽ được chuyển đổi thành một trường lặp lại. Các phần tử của hàm này không được là chuỗi hoặc ký tự chính tả.

Một lệnh chính tả được chuyển đổi thành một trường thông điệp lặp lại với các trường có tên là "key" và "value". Các mục nhập được phát theo thứ tự lặp lại (chèn). Khoá của lệnh dict phải là chuỗi hoặc int và giá trị của các lệnh này không được là chuỗi hoặc ký tự chính. Ví dụ:

proto.encode_text(struct(field=123))
# field: 123

proto.encode_text(struct(field=True))
# field: true

proto.encode_text(struct(field=[1, 2, 3]))
# field: 1
# field: 2
# field: 3

proto.encode_text(struct(field='text', ignored_field=None))
# field: "text"

proto.encode_text(struct(field=struct(inner_field='text', ignored_field=None)))
# field {
#   inner_field: "text"
# }

proto.encode_text(struct(field=[struct(inner_field=1), struct(inner_field=2)]))
# field {
#   inner_field: 1
# }
# field {
#   inner_field: 2
# }

proto.encode_text(struct(field=struct(inner_field=struct(inner_inner_field='text'))))
# field {
#    inner_field {
#     inner_inner_field: "text"
#   }
# }

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

Tham số

Thông số Mô tả
x cấu trúc; bắt buộc