BSONObj类中的函数详解（一）

1、explicit BSONObj(const char *msgdata)

explicit是c++中一个关键字。主要是用来修饰类的构造函数，表明该构造函数是显式的。详细介绍看msdn。是BSONObj类的构造函数，调用了init初始化函数。

2、 explicit BSONObj(Holder* holder) 

是BSONObj类的构造函数，即用Holder类来初始化BSONObj，也调用了init初始化函数。

3、  BSONObj()、 ~BSONObj()

BSONObj()是空的构造函数，最终结果值是{}；~BSONObj()是析构函数。

4、 bool isOwned() const

判断自己是否拥有自己的buffer，拥有的话，返回true。

5、 BSONObj getOwned() const

确认BSONObj类的buffer是在BSONObj的控制下和不是一个远程缓冲区。如果确认了返回一个BSONObj类对象。

6、BSONObj copy() const;

复制一个新的对象，并拥有自己的buffer。

7、std::string toString( bool isArray = false, bool full=false ) const;

void toString( StringBuilder& s, bool isArray = false, bool full=false, int depth=0 ) const;

将对象输出为json格式的可识别的字符串。

8、std::string jsonString( JsonStringFormat format = Strict, int pretty = 0 ) const;

适当的格式化JSON字符串。

9、   int addFields(BSONObj& from, std::set<std::string>& fields);

如果没有指定域，则添加域，返回域ID 。

10、BSONObj removeField(const StringData& name) const;

移除一个指定的域，返回一个新的对象包含剩下的域。

11、  int nFields() const;

 返回对象中有多少个域。

12、 int getFieldNames(std::set<std::string>& fields) const;

 增加域名字到域集合中。