Cocos2d-x数据篇01：UserDefault数据存储

【前言】

一个游戏怎么能没有游戏存档呢？在Cocos2d-x中也提供了一个数据存储类CCUserDefault，可以作为一个轻量级的数据库来使用。它支持五种数据bool、int、float、double、string的存储。

【Demo下载】

UserDefault数据存储

【Cocos2d-x 3.x】

（1）去掉 “CC”

（2）获取单例：sharedUserDefault() 改为 getInstance()

（3）增加数据值：Data

1 2 3 4

// void  setDataForKey( const  char * pKey,  const  Data& value); Data getDataForKey( const  char * pKey,  const  Data& defaultValue = Data::Null); //

（4）其他变化不大。

【CCUserDefault】

CCUserDefault类和之前讲的CCDirector、SimpleAudioEngine一样，都是采用单例模式。

可以通过sharedUserDefault()函数来获取其唯一的实例对象。

CCUserDefault采用XML存储技术，就是一般的键值对，这个类似C++中的map的映射（键——值）。一个关键字对应一个值。其实现的接口也比较简单实用,通过传统的set()、get()方法访问和修改值。

它支持五种数据：bool、int、float、double、string。

1、原理

（1）类似map的映射（键——值）。一个关键字对应一个值，并利用set()/get()进行访问。

（2）数据直接存储在一个XML文件中，并且文件名为程序项目的名字，如“MyTest.xml”。

（3）首次使用时，XML不存在，CCUserDefault会自动创建相应的XML文件。

2、设置数据值set

通过（键——值）的方式进行设置。

1 2 3 4 5 6 7

// void  setBoolForKey(    const  char * pKey,  bool  value);                //设置一个bool值 void  setIntegerForKey( const  char * pKey,  int  value);                 //设置一个int值 void  setFloatForKey(   const  char * pKey,  float  value);               //设置一个float值 void  setDoubleForKey(  const  char * pKey,  double  value);              //设置一个double值 void  setStringForKey(  const  char * pKey,  const  std::string& value);  //设置一个string值 //

3、获取数据值get

通过关键字，来从XML文件中获取数据值。

若关键字不存在，会自动设置（键——值）映射，并设置对应的默认值defaultValue。

1 2 3 4 5 6 7

// bool  getBoolForKey(    const  char * pKey,  bool  defaultValue =  false );                    //读取一个bool值 int  getIntegerForKey( const  char * pKey,  int  defaultValue = 0);                          //读取一个int值 float  getFloatForKey(   const  char * pKey,  float  defaultValue = 0.0);                    //读取一个float值 double  getDoubleForKey(  const  char * pKey,  double  defaultValue = 0.0);                  //读取一个double值 std::string getStringForKey(  const  char * pKey,  const  std::string& defaultValue =  "" );  //读取一个string值 //

4、保存flush

当set完后，数据不会马上保存到XML文件中。

所以一定要记得用flush()来保存数据，否则会丢失！

1 2 3

// CCUserDefault::sharedUserDefault()->flush(); //

5、其他操作

获取单例对象、释放单例对象、获取XML文件路径、判断XML文件是否已经存在。

1 2 3 4 5 6

// static  CCUserDefault* sharedUserDefault();   //获取单例对象 static  void  purgeSharedUserDefault();        //释放单例对象 const  static  std::string& getXMLFilePath();  //获取XML路径 static  bool  isXMLFileExist();                //XML文件是否已创建 //

6、使用技巧

（1）每次操作都要打长长的CCUserDefault::sharedUserDefault()，来获得单例对象。是不是很麻烦呢？可以通过宏定义来缩短长度。

1 2 3

// #define UserDefault CCUserDefault::sharedUserDefault() //

（2）在使用的时候，要特别注意：区别 const char* 和 const std::string 是不一样的！

（3）当set完后，一定要记得用flush()来保存数据，否则会丢失！

【代码实战】

代码来源于TestCpp项目中。

1、需要引用以下的头文件和命名空间

因为要用到C++的string类型。

1 2 3 4

// #include <string> using  namespace  std; //

2、宏定义获取单例对象的函数

1 2 3

// #define UserDefault CCUserDefault::sharedUserDefault() //

3、编写数据存储相关操作，并在控制台输出数据值

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36

//设置set UserDefault->setBoolForKey(    "bool" ,     true ); UserDefault->setIntegerForKey( "integer" , 100); UserDefault->setFloatForKey(   "float" ,   33.33f); UserDefault->setDoubleForKey(  "double" ,  44.44); UserDefault->setStringForKey(  "string" ,   "1111111" );   //获取get，并输出到控制台 //通过关键字，获取数据 bool  b = UserDefault->getBoolForKey( "bool" ); int  i = UserDefault->getIntegerForKey( "integer" ); float  f = UserDefault->getFloatForKey( "float" ); double  d = UserDefault->getDoubleForKey( "double" ); string ret = UserDefault->getStringForKey( "string" );   //输出到控制台 CCLOG( (b ==  true )?  "bool is true"  :  "bool is false"  ); CCLOG( "integer is %d" , i); CCLOG( "float is %f" , f); CCLOG( "double is %f" , d); CCLOG( "string is %s" , ret.c_str());   //输出XML文件路径 if ( UserDefault->isXMLFileExist() )  //是否存在 {      string path = UserDefault->getXMLFilePath();      CCLOG( "XML file is exist!" );      CCLOG(  "XML file path : %s" , path.c_str() ); } else {      CCLOG( "XML file is not exist!" ); } //保存数据 UserDefault->flush(); //

4、运行结果

5、分析与总结

（1）不知道大家是否发现输出的结果有问题？float我设置的是33.33，为何输出的是33.330002。不是应该输出33.330000才对吗？

这个就要讲讲C++浮点数的精度问题了，float是单精度浮点数，而double是双精度浮点数。float的有效精度在6~7位，超过7位就可能会失真，就像上面的那个例子一样。而double的有效精度在15~16位，超过16位才会失真。具体的原理，自行百度吧！

（2）getXMLFilePath()获取的XML文件路径为绝对路径。另外XML文件保存的路径为项目的Debug.win32中，说明XML文件是保存在应用程序所在目录下的。