protobuf c++編程筆記

更新時間：2021年08月23日 15:52:45 作者：龍海L

這篇文章主要介紹了Protobuf的c++編程筆記,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下

字段內(nèi)容的定義

//文件名：addressbook.proto
syntax = "proto2";//proto版本
//.proto文件新增一個可選的package聲明符，用來防止不同的消息類型有命名沖突。
//包的聲明符會根據(jù)使用語言的不同影響生成的代碼。對于C++，產(chǎn)生的類會被包裝在C++的命名空間中。
package tutorial;package聲明符
message Person {
  required string name = 1;//姓名，= 1 二進制編碼中使用的唯一 “標記”
  required int32 id = 2;//ID
  optional string email = 3;//email
  enum PhoneType {//枚舉消息類型
    MOBILE = 0;//proto3版本中，首成員必須為0，成員不應有相同的值
    HOME = 1;
    WORK = 2;
  }
//
  message PhoneNumber {
    required string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }
  repeated PhoneNumber phones = 4;//phones為數(shù)組
}
message AddressBook {
  repeated Person people = 1;
}

修飾符

required 必須提供該字段的值，否則消息會被認為是”未初始化的“
optional

表示屬性值為可選項，不指定使用默認值。int和char數(shù)據(jù)類型默認為0，string默認為空，bool默認為false,嵌套message默認為構造，枚舉為第一個

repeated 表示該屬性為重復字段，可看走是動態(tài)數(shù)組，類似于c++中的vector

如果為optional屬性，發(fā)送端沒有包含該屬性，則接收端在解析式采用默認值。對于默認值，如果已設置默認值，則采用默認值，如果未設置，則類型特定的默認值為使用，例如string的默認值為”“。

字段類型

package

相當于namespace

message

相當于clas

name

相當于屬性值

引用方式

類成員函數(shù)變量

package::message.方法()

標準meaasge方法

1.bool IsInitialized() const;: 檢查是否已設置所有必填 required 字段

2.string DebugString() const;: 返回 message 的人類可讀表達，對調(diào)試特別有用

3.void CopyFrom(const Person& from);用給定的 message 的值覆蓋 message

4.void Clear();: 將所有元素清除回 empty 狀態(tài)

不同字段的方法

1)optional修飾的基本類型：

set_屬性名(val) ：初始化修改屬性值；
屬性名()：獲取屬性值，只讀模式，返回類型是::google::protobuf::int64；

2）optional修飾的對象類型：

屬性名()：返回只讀的屬性類型對象的引用，屬性類型是指pb中定義的對象；
mutable_屬性名()：返回可修改的屬性類型對象的指針，屬性類型是指pb中定義的對象；
set_屬性名():初始化設置字段值

3）repeated修飾的基本類型：

add_屬性名(val)：向屬性集合中添加元素；
屬性名_size()：獲取集合大??；
屬性名(i)：返回集合中某一個元素，返回類型::google::protobuf::int64；
屬性名()：返回只讀的整個集合的引用，返回的集合類型是const ::google::protobuf::RepeatedField< ::google::protobuf::int64 >&，可以使用iterator來迭代遍歷，可用于修改；
mutable_屬性()：返回可修改的整個集合的指針，返回的集合類型::google::protobuf::RepeatedField< ::google::protobuf::int64 >*，可以使用iterator來迭代遍歷，可用于修改；
set_屬性名(int,x):設置repeated中元素的值

4）repeated修飾的對象類型：

add_屬性名()：返回可修改的屬性類型對象的指針（集合中的一個元素），屬性類型是指pb中定義的對象；
屬性名_size()：獲取集合大小；

屬性名(i)：返回集合中某一個元素，返回的是只讀的屬性類型對象的引用，屬性類型是指pb中定義的對象；

mutable_屬性名(i)：返回集合中某一個元素，返回的是可修改的屬性類型對象的指針，屬性類型是指pb中定義的對象；
屬性名()：返回只讀的整個集合的引用，集合類型是const ::google::protobuf::RepeatedPtrField< pb定義的對象>& XXX const;，可以使用iterator來迭代遍歷；
mutable_屬性名()：返回可修改的整個集合的指針，集合類型是::google::protobuf::RepeatedPtrField< pb定義的對象>*，可以使用iterator來迭代遍歷；