x引擎的数据保存
CCUserDefault:x引擎提供的数据持久化类。这个类提供各种基本数据类型的本地保存方法,任何时候都可以直接调用。被保存的数据会存放在一个叫做UserDefault.xml的XML格式文件当中。
效果:TestCpp项目在的UserDefaultTest子项目,启动这个例子项目后会生成UserDefault.xml文件保存例子数据。Windows平台下在x引擎目录的Debug.win32文件夹下。
生成的XML文件内容如下:
value2
11
2.500000
2.600000
false
其中包括了字符串、整型、浮点型、双精度型、布尔型的节点和对应的值,这里的节点名称,比如string,并不是说它的类型是string,而是它的名称,string类型是在x引擎读取数据时确定的。数据都是以Key和Value的形式成对出现。
CCUserDefault类的工作方式就是在XML文件中读取或写入配置节点,每个配置节点都是一对Key和Value值。这些Value可以支持各种数据类型,以布尔类型为例,相对应的存取方式如下。
bool CCUserDefault::getBoolForKey(const char* pKey, bool defaultValue):根据给出的Key,找到在UserDefault.xml配置文件中对应的配置节点,并将其值转换成布尔类型并作为结果返回。首先这里必须确保XML文件中的节点是可转换为布尔类型的值,如果值存在问题或者根本没有对应的节点,则返回一个指定的默认值。
void CCUserDefault::setBoolForKey(const char* pKey, bool value):与取得数据相对应,此函数用于设置指定Key和XML节点的数值。在设置过程中,如果节点不存在,x引擎就会在UserDefault.xml文件内新建这个节点;如果节点已经存在,则修改其已有Value值为新值。
使用:
设置值
CCUserDefault::sharedUserDefault()->setStringForKey("string", "value1");
CCUserDefault::sharedUserDefault()->setIntegerForKey("integer", 10);
CCUserDefault::sharedUserDefault()->setFloatForKey("float", 2.3f);
CCUserDefault::sharedUserDefault()->setDoubleForKey("double", 2.4);
CCUserDefault::sharedUserDefault()->setBoolForKey("bool", true);
CCUserDefault::sharedUserDefault()->flush();
以上代码设置了5种类型的数值,针对每一种类型
CCUserDefault都提供了对应的方法。在设置完成之后,马上调用了
flush()方法,这个方法将设置的内容从缓冲区输出到
XML文件当中,如果这句没有调用的话,
XML文件中是不会出现内容的,如果在调用
flush()函数之前就关闭了,则以上5个设置语句调用将没有任何效果。
获取值
string ret = CCUserDefault::sharedUserDefault()->getStringForKey("string");
double d = CCUserDefault::sharedUserDefault()->getDoubleForKey("double");
int i = CCUserDefault::sharedUserDefault()->getIntegerForKey("integer");
float f = CCUserDefault::sharedUserDefault()->getFloatForKey("float");
bool b = CCUserDefault::sharedUserDefault()->getBoolForKey("bool");
在设置值之后,就可以通过以上方法获取到设置好的值了。