1. 基本概念

本篇文章是介绍简单数据存储的Userdefault类,在API中:


就是存储一些简单的数据,比如声音的开启关闭,音效的开启关闭,最高分,金币数量的存储这些东西。

2. 获取

这些都是基于一些基本类型的,比如int,float,double,bool,string,二进制 这些东西,

对于它们的存取有相应的 set和 get函数,比如:

找到Userdefault.h

bool    getBoolForKey(const char* pKey);

int     getIntegerForKey(const char* pKey);

float   getFloatForKey(const char* pKey);

double  getDoubleForKey(const char* pKey);

std::string getStringForKey(const char* pKey);

Data getDataForKey(const char* pKey);// 二进制

参数里的 pKey 就是,你在设置的时候,设置的名称,类似于一个地址,通过这个地址,你可以找到这里存储的东西。 不光这样,其实里面都还有带两个参数的,比如:

bool    getBoolForKey(const char* pKey, bool defaultValue);

其他的和这个也一样,参数有两个的,都是defaultValue,只是类型不一样而已,它的含义就是,如果你通过pKey查找不到,里面没有值,你就可以让它返回defaultValue值,并且设置成defaultValue值。

其实,如果没有defaultValue也一样,只是设置并返回的是0而已:

int UserDefault::getIntegerForKey(const char* pKey)

{

return getIntegerForKey(pKey, 0);

}

int UserDefault::getIntegerForKey(const char* pKey, int defaultValue)

{

const char* value = nullptr;

tinyxml2::XMLElement* rootNode;

tinyxml2::XMLDocument* doc;

tinyxml2::XMLElement* node;

node =  getXMLNodeForKey(pKey, &rootNode, &doc);

// find the node

if (node && node->FirstChild())

{

value = (const char*)(node->FirstChild()->Value());

}

int ret = defaultValue;

if (value)

{

ret = atoi(value);

}

if(doc)

{

delete doc;

}

return ret;

}

上面那个是UserDefault类中两个关于int的get函数设置,可以看到没有defaultValue参数的,执行的是将defaultValue设置为0的函数。

3.设置

相应的对于set来说,就很简单了,只是设置值而已。

void    setBoolForKey(const char* pKey, bool value);

void    setIntegerForKey(const char* pKey, int value);

void    setFloatForKey(const char* pKey, float value);

void    setDoubleForKey(const char* pKey, double value);

void    setStringForKey(const char* pKey, const std::string & value);

void    setDataForKey(const char* pKey, const Data& value);

4.关于flush

然后就是这个flush函数了,这个函数,话说我没怎么搞太懂,网上也众说纷纭。API上说是将内容保存到XML文件中,而我查了.cpp中的定义是:

void UserDefault::flush()

{

}

没错,就是这样,而且,在我的游戏中,没有用flush函数,也没有什么异样出现。

5.如何使用

类的相应函数都介绍完了,接下来就是使用的问题,首先要确定文件是否存在,不存在就初始化它:

if ( !LoadBooleanFromXML(“_IS_EXISTED”))

{

initUserData();

SaveBooleanToXML(“_IS_EXISTED”, true);

}

5.如何使用

类的相应函数都介绍完了,接下来就是使用的问题,首先要确定文件是否存在,不存在就初始化它:

if ( !LoadBooleanFromXML(“_IS_EXISTED”))

{

initUserData();

SaveBooleanToXML(“_IS_EXISTED”, true);

}

然后,无论设置或者获取,格式都必须是:

CCUserDefault::sharedUserDefault()->setBoolForKey(m_Sound,true);

CCUserDefault::sharedUserDefault()->getBoolForKey(m_Sound);

前面都要有一长串东东,所以真正在使用时,都会设置宏定义来简化它,比如:

#define GetBool CCUserDefault::sharedUserDefault()->getBoolForKey

#define SetBool CCUserDefault::sharedUserDefault()->setBoolForKey