原型

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
通訊協定訊息處理模組。

成員

encode_text

string proto.encode_text(x)

以文字格式的通訊協定訊息形式，傳回結構體引數的編碼。 資料結構必須由字串、整數、浮點數或布林值，或是這些型別的結構體、序列和字典遞迴組成。

結構體會轉換為訊息。系統會依名稱順序發出欄位。 系統會忽略值為 None 的每個結構體欄位。

序列 (例如清單或元組) 會轉換為重複欄位。元素不得為序列或字典。

字典會轉換為訊息的重複欄位，並包含名為「key」和「value」的欄位。系統會依疊代 (插入) 順序發出項目。 字典的鍵必須是字串或整數，值則不得為序列或字典。 範例：

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
# }

參數

參數 說明
x 必要