x引擎的数据保存
CCUserDefault:x引擎提供的数据持久化类。这个类提供各种基本数据类型的本地保存方法,任何时候都可以直接调用。被保存的数据会存放在一个叫做UserDefault.xml的XML格式文件当中。
效果:TestCpp项目在的UserDefaultTest子项目,启动这个例子项目后会生成UserDefault.xml文件保存例子数据。Windows平台下在x引擎目录的Debug.win32文件夹下。
<?xml version="1.0" encoding="UTF-8"?> <userDefaultRoot> <string>value2</string> <integer>11</integer> <float>2.500000</float> <double>2.600000</double> <bool>false</bool> </userDefaultRoot>
其中包括了字符串、整型、浮点型、双精度型、布尔型的节点和对应的值,这里的节点名称,比如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");在设置值之后,就可以通过以上方法获取到设置好的值了。