数据本地化
A CCUserDefault
系统会在默认路径cocos2d-x-2.2.3\projects\Hello\proj.win32\Debug.win32下生成一个名为UserDefault.xml.所有的key皆为char *型,value类型为bool intfloat double std::string.
读操作
bool getBoolForKey(const char* pKey); bool getBoolForKey(const char* pKey, bool defaultValue);
int getIntegerForKey(const char* pKey); int getIntegerForKey(const char* pKey, int defaultValue);
float getFloatForKey(const char* pKey); float getFloatForKey(const char* pKey, float defaultValue);
double getDoubleForKey(const char* pKey); double getDoubleForKey(const char* pKey, double defaultValue);
std::string getStringForKey(const char * pKey); std::string getStringForKey(const char* pKey,const std::string &defaultValue); |
对于没有defaultValue的get方法,如果文件中没有相应的key,则得到的是0,如果有则相应的值。
对于有defaultValue的get方法,如果文件中没有相应的key,则得到的是defaultValue,如果有,则返回文件中的相应的值。
B 写操作
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); |
Set方法有个特点,是对于相对的key后面会对前面产生覆盖效果。
C 写入文件
CCUserDefault::sharedUserDefault()->flush(); |
虽然window平台是空,但是由于跨平台所导致的。
2 Xml文档格式
简介
XML被设计用来传输和存储数据
语法
A 开头
<?xml version=”1.0” encoding=”utf-8”?> |
B XML文档必须有根元素
XML文档必须有一个元素是所有其他元素的父元素。该元素称为根元素。 <root> <child> <subchild>…..</subchild> </child> </root> |
C 所有XML元素都必须有关闭标签
<p>This is a paragraph</p> <p>This is another paragraph</p> |
D 在XML中,XML的属性值须加引号。
<note date="08/08/2008"> <to>George</to> <from>John</from> </note> |
E XML中的注释
<!— This is a comment --> |
XML元素
指的是从(且包括)开始标签直到(且包括)结束标签的部分。
元素可包含其他元素、文本或者两者的混合物。元素也可以拥有属性。 <bookstore> <book category="CHILDREN"> <title>Harry Potter</title> <author>J K. Rowling</author> <year>2005</year> <price>29.99</price> </book> <book category="WEB"> <title>Learning XML</title> <author>Erik T. Ray</author> <year>2003</year> <price>39.95</price> </book> </bookstore> |
例:
<?xml version="1.0" encoding="ISO-8859-1"?> <note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note> |
F: 生成xml文档
头文件
#include "support/tinyxml2/tinyxml2.h" using namespace tinyxml2; |
void makeXML(const char * fileName) { std::string filePath = CCFileUtils::sharedFileUtils()->getWritablePath() + fileName; tinyxml2::XMLDocument *pDoc = new tinyxml2::XMLDocument();
//xml 声明(参数可选) XMLDeclaration *pDel = pDoc->NewDeclaration("xml version=\"1.0\" encoding=\"UTF-8\""); pDoc->LinkEndChild(pDel);
//添加plist 节点 XMLElement *plistElement = pDoc->NewElement("plist"); plistElement->SetAttribute("version", "1.0"); pDoc->LinkEndChild(plistElement); XMLComment *commentElement = pDoc->NewComment("this is xml comment"); plistElement->LinkEndChild(commentElement);
//添加dic 节点 XMLElement *dicElement = pDoc->NewElement("dic"); plistElement->LinkEndChild(dicElement);
//添加key 节点 XMLElement *keyElement = pDoc->NewElement("key"); keyElement->LinkEndChild(pDoc->NewText("Text")); dicElement->LinkEndChild(keyElement); XMLElement *arrayElement = pDoc->NewElement("array"); dicElement->LinkEndChild(arrayElement); for (int i = 0; i < 3; i++) { XMLElement *elm = pDoc->NewElement("name"); elm->LinkEndChild(pDoc->NewText("Cocos2d-x")); arrayElement->LinkEndChild(elm); } pDoc->SaveFile(filePath.c_str()); pDoc->Print(); delete pDoc; } |
在cocos2d-x-2.2.3\projects\Hello\proj.win32\Debug.win32下
<?xml version="1.0" encoding="UTF-8"?> <plist version="1.0"> <!--this is xml comment--> <dic> <key>Text</key> <array> <name>Cocos2d-x</name> <name>Cocos2d-x</name> <name>Cocos2d-x</name> </array> </dic> </plist> |
17.3.4解析xml
void parseXML(const char * fileName) { std::string filePath = CCFileUtils::sharedFileUtils()->getWritablePath() + fileName; tinyxml2::XMLDocument *pDoc = new tinyxml2::XMLDocument(); XMLError errorId = pDoc->LoadFile(filePath.c_str());
if (errorId != 0) { //xml 格式错误 return; }
XMLElement *rootEle = pDoc->RootElement(); //获取第一个节点属性 const XMLAttribute *attribute = rootEle->FirstAttribute(); //打印节点属性名和值 CCLog("attribute_name = %s,attribute_value = %s", attribute->Name(), attribute->Value()); XMLElement *dicEle = rootEle->FirstChildElement("dic"); XMLElement *keyEle = dicEle->FirstChildElement("key");
if (keyEle) { CCLog("keyEle Text= %s", keyEle->GetText()); }
XMLElement *arrayEle = keyEle->NextSiblingElement(); XMLElement *childEle = arrayEle->FirstChildElement();
while (childEle) { CCLog("childEle Text= %s", childEle->GetText()); childEle = childEle->NextSiblingElement(); }
delete pDoc; } |
attribute_name = version,attribute_value = 1.0 keyEle Text= Text childEle Text= Cocos2d-x childEle Text= Cocos2d-x childEle Text= Cocos2d-x |
UserDefault.Xml操作案例:
T22UserDefault.h |
#ifndef __T22CCUserDefault_H__ #define __T22CCUserDefault_H__ #include "cocos2d.h" #include "TBack.h"
class T22CCUserDefault :public TBack { public: CREATE_FUNC(T22CCUserDefault); bool init(); static CCScene * scene();
void makeXML(char * fileName); void parseXML(char * fileName); };
#endif |
T22UserDefault.cpp |
#include "T22UserDefault.h" #include "AppMacros.h" #include "support/tinyxml2/tinyxml2.h"
using namespace tinyxml2;
CCScene * T22CCUserDefault::scene() { CCScene * scene = CCScene::create(); T22CCUserDefault * layer = T22CCUserDefault::create(); scene->addChild(layer); return scene; }
bool T22CCUserDefault::init() { TBack::init(); //通过这种方式向UserDefault.xml中写内容 CCUserDefault::sharedUserDefault()->setIntegerForKey("integer", 100); CCUserDefault::sharedUserDefault()->setStringForKey("string","oooo"); //获得xml的路径 std::string str = CCUserDefault::sharedUserDefault()->getXMLFilePath(); //打印xml的路径 CCLog("path = %s", str.c_str());
CCLog("isXMLExist = %d", CCUserDefault::sharedUserDefault()->isXMLFileExist());
CCUserDefault::sharedUserDefault()->flush(); //如果有这个key的值则打印出,如果没有这个key则返回默认的值120 int value = CCUserDefault::sharedUserDefault()->getIntegerForKey("integer", 120); CCLog("value = %d", value);
return true; } |
运行结果:
UserDefault.xml的内容:
|
操作xml和解释xml
#include "T22UserDefault.h" #include "AppMacros.h" #include "support/tinyxml2/tinyxml2.h"
using namespace tinyxml2;
CCScene * T22CCUserDefault::scene() { CCScene * scene = CCScene::create(); T22CCUserDefault * layer = T22CCUserDefault::create(); scene->addChild(layer); return scene; }
bool T22CCUserDefault::init() { TBack::init();
makeXML("test"); parseXML("test");
return true; }
void T22CCUserDefault::makeXML(char * fileName) { std::string filePath = CCFileUtils::sharedFileUtils()->getWritablePath() + fileName;
tinyxml2::XMLDocument *pDoc = new tinyxml2::XMLDocument(); //xml 声明(参数可选) XMLDeclaration *pDel = pDoc->NewDeclaration("xml version=\"1.0\" encoding = \"UTF-8\""); pDoc->LinkEndChild(pDel); //添加 plist 节点 XMLElement *plistElement = pDoc->NewElement("plist"); plistElement->SetAttribute("version", "1.0"); pDoc->LinkEndChild(plistElement);
XMLComment *commentElement = pDoc->NewComment("this is x comment"); plistElement->LinkEndChild(commentElement); //添加 dic 节点 XMLElement *dicElement = pDoc->NewElement("dic"); plistElement->LinkEndChild(dicElement); //添加 key 节点 XMLElement *keyElement = pDoc->NewElement("key"); keyElement->LinkEndChild(pDoc->NewText("Text")); dicElement->LinkEndChild(keyElement);
XMLElement *arrayElement = pDoc->NewElement("array"); dicElement->LinkEndChild(arrayElement); for (int i = 0; i < 3; i++) { XMLElement *elm = pDoc->NewElement("name"); elm->LinkEndChild(pDoc->NewText("Cocos2d-x")); arrayElement->LinkEndChild(elm); } pDoc->SaveFile(filePath.c_str()); pDoc->Print(); delete pDoc; }
void T22CCUserDefault::parseXML(char * fileName) { std::string filePath = CCFileUtils::sharedFileUtils()->getWritablePath() + fileName; tinyxml2::XMLDocument *pDoc = new tinyxml2::XMLDocument(); XMLError errorId = pDoc->LoadFile(filePath.c_str()); if (errorId != 0) { //xml 格式错误 return; } XMLElement *rootEle = pDoc->RootElement(); //获取第一个节点属性 const XMLAttribute *attribute = rootEle->FirstAttribute(); //打印节点属性名和值 CCLog("attribute_name = %s,attribute_value = %s", attribute->Name(), attribute->Value());
XMLElement *dicEle = rootEle->FirstChildElement("dic"); XMLElement *keyEle = dicEle->FirstChildElement("key"); if (keyEle) { CCLog("keyEle Text= %s", keyEle->GetText()); } XMLElement *arrayEle = keyEle->NextSiblingElement(); XMLElement *childEle = arrayEle->FirstChildElement(); while (childEle) { CCLog("childEle Text= %s", childEle->GetText()); childEle = childEle->NextSiblingElement(); } delete pDoc; } |
运行结果:
Xml文件:
|
CCString,CCArray,CCDictionary
init()方法中
CCString *str = CCString::create("1234"); CCLog("CCString str = %s", str->getCString()); CCLog("CCString intTypeValue = %d", str->intValue()); |
运行结果:
|
数据结构:CCString
/*使用std::string 创建了一个字符串, 你也可以传递一个c 字符串指针,因为 std::string 的构造函数可以访问c 字符串指针 * @返回的CCString 指针是一个自动释放对象, *也就意味着你不需要调用release 操作,除非你retain 了. */ static CCString* create(const std::string& str); /*使用格式化方式来创建一个字符串,这个方法和c 语言里面的‘sprintf’类似,默认 缓存大小是(1024*100)bytes *假如你想要改变这个缓存大小,你可以去CCString.cpp 中,更改kMaxStringLen 这个宏定义。 * @返回的CCString 指针是一个自动释放对象, *也就意味着你不需要调用release 操作,除非你retain 了. */ static CCString* createWithFormat(const char* format, …); /* 使用二进制数据来创建字符串 * @返回的CCString 指针是一个自动释放对象, *也就意味着你不需要调用release 操作,除非你retain 了. */ static CCString* createWithData(const unsigned char* pData, unsigned long nLen); /*使用一个文件来创建一个字符串, * @return A CCString pointer which is an autorelease object pointer, * it means that you needn't do a release operation unless you retain it. */ static CCString* createWithContentsOfFile(const char* pszFileName); |
转换 |
CCString 允许CCString 实例变量转换为另外类型的变量。 |
/* convert to int value */ int intValue() const; /* convert to unsigned int value */ unsigned int uintValue() const; /* convert to float value */ float floatValue() const; /* convert to double value */ double doubleValue() const; /* convert to bool value */ bool boolValue() const; |
常见的宏定义 |
#define CCStringMake(str) CCString::create(str) #define ccs CCStringMake |
CCArray
CCArray是一个面向对象包装类
CCArray继承至CCObject(CCObject主要是为了自动内存管理而创建的)并且提供了一系列接口。
创建
/** 创建一个数组*/ static CCArray* create(); /** 使用一些对象创建数组*/ static CCArray* create(CCObject* pObject, …); /** 使用一个对象创建数组*/ static CCArray* createWithObject(CCObject* pObject); /** 创建一个指定大小的数组*/ static CCArray* createWithCapacity(unsigned int capacity); /** 使用一个现有的CCArray 数组来新建一个数组*/ static CCArray* createWithArray(CCArray* otherArray); |
插入
/** 插入一个对象*/ void addObject(CCObject* object); /** 插入别外一个数组里面的全部对象*/ void addObjectsFromArray(CCArray* otherArray); /** 在一个确定的索引位置插入一个对象*/ void insertObject(CCObject* object, unsigned int index); |
删除
/** 移除最后的一个对象*/ void removeLastObject(bool bReleaseObj = true); /**移除一个确定的对象*/ void removeObject(CCObject* object, bool bReleaseObj = true); /** 移除一个确定索引位置的元素*/ void removeObjectAtIndex(unsigned int index, bool bReleaseObj = true); /** 移除全部元素*/ void removeObjectsInArray(CCArray* otherArray); /** 移除所有对象*/ void removeAllObjects(); /** 快速移除一个对象*/ void fastRemoveObject(CCObject* object); /** 快速移除一个确定索引位置的对象*/ void fastRemoveObjectAtIndex(unsigned int index); |
remove 和fastRemove 有什么区别,可以看看源代码,remove 是从CCArray中完全的移除,fastRemove 只是将CCArray 中对应的对象释放掉了,没够改变整个CCArray 的结构。从代码上来看,区别在于删除元素之后,是否把数组之后的元素向前移动覆盖掉之前位置的元素。代码上的差别如下所示:
unsigned int remaining = arr->num - index; if(remaining>0) { memmove((void *)&arr->arr[index], (void *)&arr->arr[index+1], remaining * sizeof(CCObject*)); } |
遍历
CCARRAY_FOREACH(arr, obj)
主要事项
CCArray 一般不会被增加到其他类中,所以他的引用计数是1,并且设置为autorelease 对象。创建CCArray 对象并且retain,然后在这个类中的析构函数中调用release 方法来释放内存。
如果CCObject 对象添加到CCArray 中,那么CCObject 对象的引用计数将
会加1.
CCDictionary
CCDirtionary使用UTHash实现的
关键字类型
CCDictionary支持两种类型的关键字,一个是std::string,一个是int.一个CCDictionary实例对象只支持唯一的关键字。所以在你调用”setObject”方法的时候,你需要确认一下。
创建
static CCDictionary * create(); static CCDictionary * createWithDictionary(CCDictionary *srcDict) static CCDictionary * createWithContentsOffFile(const char * pFileName); |
插入
相同key的value会发生覆盖行为。
void setObject(CCObject *pObject,const std::string &key); void setObject(CCObject *pObject,intptr_t key); |
删除
void removeObjectForKey (const std::string &key) void removeObjectForKey (intptr_t key) void removeObjectsForKeys (CCArray *pKeyArray) void removeObjectForElememt (CCDictElement *pElement) void removeAllObjects () |
遍历
实现了CCDICT_FOREACH 方法来遍历整个字典。而且使用CCDICT_FOREACH 的方式和使用CCARRAY_FOREACH 的方式非常类似
CCDictElement* pElement = NULL; CCDICT_FOREACH(theDict, pElement) { CCObjectSubClass* pSubClassObj = (CCObjectSubClass*)pElement->getObject(); // 你也可以得到当前key,但是你需要确定key 的类型。 std::string oneStrKey = pElement->getStrKey(); // 假如key 的类型是string // int oneIntKey = pElement->getIntKey(); // 假如有key 的类型是integer // 下面就可以使用上面pSubClassObj 对象做一些操作了 } |
举例
// Create a dictionary, return an autorelease object. CCDictionary* pDict = CCDictionary::create(); // Insert objects to dictionary CCString* pValue1 = CCString::create("100"); CCString* pValue2 = CCString::create("120"); CCInteger* pValue3 = CCInteger::create(200); pDict->setObject(pValue1, "key1"); pDict->setObject(pValue2, "key2"); pDict->setObject(pValue3, "key3"); // Get the object for key CCString* pStr1 = (CCString*)pDict->objectForKey("key1"); CCLog("{ key1: %s }", pStr1->getCString()); CCInteger* pInteger = (CCInteger*)pDict->objectForKey("key3"); CCLog("{ key3: %d }", pInteger->getValue()); |
结合xml支持中文
CCDictionary * dic = CCDictionary::createWithContentsOfFile("chinese.xml"); CCString * str = (CCString *)dic->objectForKey("people1"); CCLabelTTF * ttf = CCLabelTTF::create(str->getCString(), "Arial",20); ttf->setPosition(ccp(240, 160)); addChild(ttf); return true; |
案例:
bool T22CCUserDefault::init() { TBack::init();
CCDictionary * dic = CCDictionary::create(); dic->retain();
CCString *value1 = CCString::create("100"); CCString *value2 = CCString::create("200");
//第一个是value,第二个是key的意思 dic->setObject(value1, "key1"); dic->setObject(value2, "key2");
CCString * str2 = (CCString *)dic->objectForKey("key1"); //运行结果100 CCLog("%d", str2->intValue());
CCLabelTTF * ttf = CCLabelTTF::create(str2->getCString(), "Courier New", 30); ttf->setPosition(ccp(240,160)); addChild(ttf);
return true; } |
运行结果:
|