标签：
尊重原创：http://cn.cocos2d-x.org/tutorial/show?id=2418
【前言】
一个游戏怎么能没有游戏存档呢？在Cocos2d-x中也提供了一个数据存储类CCUserDefault，可以作为一个轻量级的数据库来使用。它支持五种数据bool、int、float、double、string的存储。
【Demo下载】
【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文件是保存在应用程序所在目录下的。
Cocos2d-x数据篇01：UserDefault数据存储
标签：
原文地址：http://www.cnblogs.com/LeavesSmallAnt/p/4594707.html
