【玩转cocos2d-x之二十六】数据结构CCDictionary

Cocos2d-x 前端之家
前端之家收集整理的这篇文章主要介绍了【玩转cocos2d-x之二十六】数据结构CCDictionary，前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。

原创作品，转载请标明：http://www.jb51.cc/article/p-azlvldlh-ep.html


CCDictionary在cocos2d-x中被大量的应用，比如CCTexureCache，CCSpriteFramCache等等。


1.实现原理


1.1.uthash

CCDictionary是使用uthash实现的，而过时的CCMutableDictionary则是使用STL实现，就效率而言CCDictionary至少提升了两倍，而且CCDictionary并没有使用C++模版，因此也很容易绑定到脚本。

uthash是一个C/C++的哈希表实现，它以宏定义的方式实现了哈希表，不仅加快了运行速度，而且与key类型无关。它的github地址是https://github.com/troydhanson/uthash。cocos2d-x的头文件在\cocos2d-x-2.2.0\cocos2dx\support\data_support\uthash.h。

如果想在C++中直接使用也很简单，userguide在这里：http://troydhanson.github.io/uthash/userguide.html。可以很方便地进行增加，删除，查找，计数，迭代，排序等操作。


1.2.键（key）

uthash支持4种标准类型的键：整型，字符串，指针和结构体，不过到了CCDictionary就只支持整型和字符串型了。

[cpp] view plain copy
  1. enumCCDictType
  2. {
  3. kCCDictUnknown=0,
  4. kCCDictStr,
  5. kCCDictInt
  6. };


2.CCDictElement

在了解CCDictionary之前还要看一下CCDictElement，很明显，CCDictElement是CCDictionary的一个元素，包含了一个key-value。key支持整型和字符串，使用的时候要注意在同一个CCDictionary中key类型必须要一致，value可以不一致。


3.API

3.1.创建

copy
    //创建一个CCDictionary
  1. staticCCDictionary*create();
  2. //用一个已存在的CCDictionary来创建一个新的CCDictionary
  3. staticCCDictionary*createWithDictionary(CCDictionary*srcDict);
  4. //用一个plist来创建CCDictionary
  5. staticCCDictionary*createWithContentsOfFile(constchar*pFileName);
  6. //返回一个非autorelease对象的CCDictionary，它讷讷感够确保在新线程中使用
  7. //但是你必须手动管理它的生命周期，当你不再需要它的时候，必须调用CC_SAFE_RELEASE
  8. staticCCDictionary*createWithContentsOfFileThreadSafe(char*pFileName);

3.2.查找

copy
    //返回指定字符串类型key的value，如果CCDictionary的key是整型，会出现断言
  1. CCObject*objectForKey(conststd::string&key);
  2. //返回指定整型key的value，如果CCDictionary的key是字符串型，会出现断言
  3. CCObject*objectForKey(intptr_tkey);
  4. //返回指定字符串类型key的CCString，这里假定value是CCString型，如果不是或者未找到，则返回空串
  5. constCCString*valueForKey(//返回指定整型类型key的CCString，这里假定value是CCString型，如果不是或者未找到，则返回空串
  6. constCCString*valueForKey(intptr_tkey);

3.3.增加

copy
    //插入一个key-value，如果是第一次调用，那么CCDictionary的key类型会被确定为字符串型，之后就不能插入整型key
  1. //如果已存在该key，则旧key-value会被释放和移除，被新的替代
  2. voidsetObject(CCObject*pObject,conststd::string&key);
  3. //插入一个key-value，如果是第一次调用，那么CCDictionary的key类型会被确定为整型，之后就不能插入字符串型key
  4. //如果已存在该key，则旧key-value会被释放和移除，被新的替代
  5. intptr_tkey);

3.4.移除

copy
    //移除指定key
  1. voidremoveObjectForKey(voidremoveObjectForKey(intptr_tkey);
  2. //移除一个CCArray中keys
  3. voidremoveObjectsForKeys(CCArray*pKeyArray);
  4. //通过元素来移除value
  5. voidremoveObjectForElememt(CCDictElement*pElement);
  6. //移除所有的key-value
  7. voidremoveAllObjects();

3.5.其他

copy
    //返回一个随机元素，这个使用得注意，因为value可以不一样，所以返回类型每次都可能不同，在类型转换的时候要非常小心
  1. CCObject*randomObject();
  2. //返回一个包含所有key的CCArray
  3. CCArray*allKeys();
  4. //返回指定value的所有key，因为value是可以相同的，内部使用==比较两个value是否相同
  5. CCArray*allKeysForObject(CCObject*object);
  6. //返回元素个数
  7. unsignedintcount();
  8. //把CCDictionary写到一个plist中，写入的value要求是字符串型
  9. boolwriteToFile(char*fullPath);

4.示例

copy
    //Createadictionary,returnanautoreleaSEObject.
  1. CCDictionary*pDict=CCDictionary::create();
  3. //Insertobjectstodictionary
  4. CCString*pValue1=CCString::create("100");
  5. CCString*pValue2=CCString::create("120");
  6. CCInteger*pValue3=CCInteger::create(200);
  7. pDict->setObject(pValue1,"key1");
  8. pDict->setObject(pValue2,"key2");
  9. pDict->setObject(pValue3,"key3");
  10. //Gettheobjectforkey
  11. CCString*pStr1=(CCString*)pDict->objectForKey("key1");
  12. CCLog("{key1:%s}",pStr1->getCString());
  13. CCInteger*pInteger=(CCInteger*)pDict->objectForKey("key3");
  14. CCLog("{key3:%d}",pInteger->getValue());
  15. CCString*pStr3=static_cast<CCString*>(pDict->randomObject());//这里有问题了，因为value有不同类型，所以随机返回时类型处理要小心
  16. CCLog("{randomkey:%s}",pStr3->getCString());//如果返回的是整型pValue3，那么会出现断言
  17. if(pDict->writeToFile("pdic.plist"))//整型的value无法写入，会提示Thistypecannotappearinpropertylist
  18. CCLog("Writetofilesuccess!");
Resource/pdic.plist

[html] copy
    <?xmlversion="1.0"encoding="UTF-8"?>
  1. <!DOCTYPEplistPUBLIC"-//Apple//DTDPLIST1.0//EN""http://www.apple.com/DTDs/PropertyList-1.0.dtd"/>
  2. <plistversion="1.0">
  3. dict>
  4. key>key1</string>100>key2>120>key3><!key3对应整型数据无法写入plist>

5.CCDICT_FOREACH


5.1.概况

宏定义，用于遍历CCDictionary的value。

copy
    #defineCCDICT_FOREACH(__dict__,__el__)\
  1. CCDictElement*pTmp##__dict__##__el__=NULL;\
  2. if(__dict__)\
  3. HASH_ITER(hh,(__dict__)->m_pElements,__el__,pTmp##__dict__##__el__)

5.2.示例

copy
    CCDictElement*pElement;
  1. CCDICT_FOREACH(dict,pElement)
  2. {
  3. char*key=pElement->getStrKey();
  4. //Youcertainlyknowthetypeofvalue,soweassumethatit'saCCSprite.
  5. CCSprite*pSprite=(CCSprite*)pElement->getObject();
  6. //......
  7. }
原文链接：https://www.f2er.com/cocos2dx/342132.html

猜你在找的Cocos2d-x相关文章

创建自定义的Cocos2d-x场景
操作步骤 1、创建cocos2d-x工程 2、新建 Scene1.cpp Scene1.h Scene1.h代码 #ifndef __SCE...
给vs2010安装上cocos2d-x的模版
开发环境：OS(WINDOWS 8.1 X64 企业版) cocos2d-x 2.2.1 vs2010 想给vs安装上cocos的模版，...
Python创建Cocos2d-x 2.2方法
把创建项目做成一个批处理，当创建项目时可以省时省力很多。 操作步骤 1、在 E:cocos2d-x-...
cocos2dx 物理碰撞
https://www.cnblogs.com/JiaoQing/p/3906780.html 四个响应函数 1 EventListenerPhysics...
cocos2d-js 自定义事件监听派发
转载于 http://www.cnblogs.com/kenkofox/p/3926797.html 熟悉js的dom事件或者flash事件的...
cocos常用 实用 公共函数 lua代码
公共资源加载，缓存retain；防止被自动销毁 2. 数字滚动递增；用于得奖后，总金币跳动增加...
cocos creator box2d
title Map 使用box2d var sfloors = this.tiledMap.getObjectGroup(‘Special_Floor‘).g...
（转）让quick-cocos2d-x支持加密的plist文件
前篇：quick-cocos2d-x图片资源加密 在前篇里面，我们实现了图片资源的加密，但还没有实现...
（转）quick-cocos2d-x图片资源加密(续)
摘要: 对在quick-cocos2d-x上实现的资源加密方法的补充 前篇： quick-cocos2d-x图片资源加...
Cocos Creator 动态改变sprite图片
首先将存放图片最外层文件夹命名为resources 　　 changeBj: function(){ 　　　　var url...
iOSAndroidSwiftHybridCocos2d-xFlutterXcodeSilverlightcocoaCordova
调试桥筛选栏假异步不会丢失AndPermissio权限申请抽屉式systemUI信号栏多行排列跨多行显示viewmode数据共享录制语音视频通话多行显示Studio3.5拉伸控件望远镜发动态走势图点赞控件显示牌冷启动v3签名v2签名v1签名本地html外接键盘流式标签