giao thức

Báo cáo sự cố Xem nguồn

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ề phương thức 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 được định nghĩa bao gồm chuỗi, số nguyên, số thực hoặc số bools, hoặc cấu trúc, chuỗi và lệnh thuộc những loại này.

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

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

Một lệnh được chuyển đổi thành trường thông báo lặp lại với các trường có tên là "khoá" và "giá trị". Các mục nhập được phát theo thứ tự lặp lại (chèn). Khoá của ký tự phải là chuỗi hoặc số nguyên và giá trị của khoá không được là chuỗi hoặc số nguyên. 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
# }

Các tham số

Thông số Nội dung mô tả
x bắt buộc