__Dictionary类在Cocos2d-x 2.x时代它就是CCDictionary类,它是模仿Objective-C中的NSDictionary类而设计的,通过引用计数管理内存。__Dictionary继承于Ref类,因此它所能容纳的是Ref及子类所创建的对象指针。
1、创建__Dictionary对象
创建__Dictionary对象有很多函数,下面是总结常用的函数:
static __Dictionary* create()。创建__ Dictionary。
static __Dictionary* createWithDictionary(__Dictionary* srcDict)。用一个已存在的__Dictionary来创建一个新的__Dictionary。
static __Dictionary* createWithContentsOfFile(const char *pFileName)。从属性列表文件创建__Dictionary。
2、添加元素
向__Dictionary对象中添加元素都必须是“键-值”对,“键”可以是字符串(std::string)类型或整数(signed int)类型,而“值”必须是Ref和其子类的对象指针类型。下面是总结常用的函数:
void setObject(Ref* pObject, const std::string& key)。插入一个“键-值”对,其中pObject是“值”,key是“键”。如果是第一次调用,__Dictionary的“键”类型是字符串型,之后就不能插入整型“键”。如果已存在该“键”,则旧“键-值”对会被释放和移除,被新的替代。
void setObject(Ref* pObject, intptr_t key)。插入一个“键-值”对,其中pObject是“值”,key是“键”, intptr_t类型是signed int类型的别名,为整型。如果是第一次调用,__Dictionary的“键”类型是整型,之后就不能插入字符串型“键”,如果已存在该“键”,则旧“键-值”对会被释放和移除,被新的替代。
3、移除元素
下面是总结常用的移除__Dictionary容器中元素的函数:
void removeObjectForKey(const std::string& key)。通过指定键移除元素。
void removeObjectForKey(intptr_t key)。通过指定键移除元素。
void removeObjectsForKeys(__Array* pKeyArray)。通过一个__Array中键集合移除元素。
void removeObjectForElememt(DictElement* pElement)。通过指定元素来移除。
void removeAllObjects()。移除所有的元素。
4、查找元素
我们还可以通过下面函数对__Dictionary容器中元素查找:
Ref* objectForKey(const std::string& key)。返回指定字符串类型“键”的“值”。
Ref* objectForKey(intptr_t key)。返回指定整型“键”的“值”。
const __String* valueForKey(const std::string& key)。返回指定字符串类型“键”的“值”,返回值是__String指针类型,这里假定“值”是__String指针型,如果不是或者未找到,则返回空串。
const __String* valueForKey(intptr_t key)。返回指定整型“键”的“值”,返回值是__String指针类型,这里假定“值”是__String指针,如果不是或者未找到,则返回空串。
5、其它操作函数
此外还有很多操作__Dictionary对象函数,下面是总结常用的函数:
__Array* allKeys()。返回一个包含所有“键”的“值”的__Array容器。
unsigned int count()。返回元素个数。
bool writeToFile(const char *fullPath)。把__Dictionary写到一个属性列表文件中,写入的“值”要求是字符串型。
6、遍历__Dictionary容器
Cocos2d-x提供了两个遍历__Dictionary容器的宏:
CCDICT_FOREACH。遍历__Dictionary容器。
实例:__Dictionary容器
下面我们通过一个实例介绍__Dictionary字典容器中的相关函数。如图所示场景,点击右下角的Go按钮,在场景中添加100个Ball精灵和100个icon精灵。
__Dictionary字典容器实例
为了学习__Dictionary类的使用,我们在程序中分别创建100个Ball精灵和100个icon精灵,并把它们分别添加到不同的__Dictionary容器中。
下面我们看看代码部分,HelloWorldScene.h代码如下:
- #ifndef __HELLOWORLD_SCENE_H__
- #define __HELLOWORLD_SCENE_H__
- #include "cocos2d.h"
- #define MAX_COUNT 100 ①
- class HelloWorld : public cocos2d::Layer
- {
- cocos2d::__Dictionary* dict1; ②
- cocos2d::__Dictionary* dict2; ③
- public:
- ~HelloWorld(); ④
- static cocos2d::Scene* createScene();
- virtual bool init();
- void menuCloseCallback(cocos2d::Ref* pSender);
- CREATE_FUNC(HelloWorld);
- };
- #endif // __HELLOWORLD_SCENE_H__
上述代码第①行代码#define MAX_COUNT 100定义宏MAX_COUNT,MAX_COUNT定义了一次生成的精灵数。第②和③行代码声明__Dictionary*的成员变量dict1和dict2。第④行代码是声明析构函数,我们需要在析构函数中释放成员变量dict1和dict2。
HelloWorldScene.cpp中的init函数代码如下:
- bool HelloWorld::init()
- {
- if ( !Layer::init() )
- {
- return false;
- }
- Size visibleSize = Director::getInstance()->getVisibleSize();
- Vec2 origin = Director::getInstance()->getVisibleOrigin();
- auto goItem = MenuItemImage::create(
- "go-down.png",
- "go-up.png",
- CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
- goItem->setPosition(Vec2(origin.x + visibleSize.width - goItem->getContentSize().width/2 ,
- origin.y + goItem->getContentSize().height/2));
- auto menu = Menu::create(goItem, NULL);
- menu->setPosition(Vec2::ZERO);
- this->addChild(menu, 1);
- this->dict1 = __Dictionary::create(); ①
- this->dict1->retain(); ②
- this->dict2 = __Dictionary::create();
- this->dict2->retain();
- for(int i = 0;i < MAX_COUNT; ++i){ ③
- auto sprite1 = Sprite::create("Ball.png"); ④
- this->dict1->setObject(sprite1, i); ⑤
- auto sprite2 = Sprite::create("icon.png"); ⑥
- __String *key = __String::createWithFormat("key%d",i); ⑦
- this->dict2->setObject(sprite2, key->getCString()); ⑧
- }
- return true;
- }
init是初始化场景的函数,我们在该函数中创建了200个精灵,并把它们分别放到__Dictionary*类型的dict1 和dict2成员变量中。其中第①行代码是创建__Dictionary*类型的dict1成员变量,使用create函数。第②行代码this->dict1->retain()非常重要,retain是保持dict1对象在一个游戏循环事件后内存不会自动释放,这涉及到Ref内存管理问题,我们将在第19章给大家详细介绍。如果this->dict1->retain()语句,dict1对象会被释放,在其它函数dict1容器对象就会出错。
第③行代码是循环创建精灵对象。第④行代码是创建Ball精灵对象,第⑤行代码this->dict1->setObject(sprite1, i)是使用循环变量i作为键,把Ball精灵对象添加到dict1容器对象中。第⑥行代码是创建icon精灵对象。第⑦行代码是根据循环变量i,创建字符串,如:key0、key1等形式。第⑧行代码把icon精灵对象添加到dict2容器对象中。
需要注意的是这些精灵对象还没有被添加到场景中,因此,场景显示的时候它们是不出现的。
HelloWorldScene.cpp中的menuCloseCallback函数代码如下:
- void HelloWorld::menuCloseCallback(Ref* pSender)
- {
- Size visibleSize = Director::getInstance()->getVisibleSize();
- DictElement* pElement; ①
- log("Dict1 key-value count = %d",this->dict1->count());
- CCDICT_FOREACH(dict1, pElement) ②
- {
- int key = pElement->getIntKey(); ③
- log("Add Sprite %d", key);
- Sprite* sprite = (Sprite*)pElement->getObject(); ④
- int x = CCRANDOM_0_1() * visibleSize.width;
- int y = CCRANDOM_0_1() * visibleSize.height;
- sprite->setPosition( Vec2(x, y) );
- this->removeChild(sprite);
- this->addChild(sprite);
- }
- log("Dict2 key-value count = %d",this->dict2->count());
- CCDICT_FOREACH(dict2, pElement) ⑤
- {
- const char *key = pElement->getStrKey(); ⑥
- log("Add Sprite %s", key);
- Sprite* sprite = (Sprite*)pElement->getObject();
- int x = CCRANDOM_0_1() * visibleSize.width;
- int y = CCRANDOM_0_1() * visibleSize.height;
- sprite->setPosition( Vec2(x, y) );
- this->removeChild(sprite);
- this->addChild(sprite);
- }
- }
该函数是在玩家触摸Go按钮之后调用的函数,其中第①行代码DictElement* pElement是__Dictionary元素(DictElement)指针,它将在循环遍历中使用。DictElement类的主要函数如下:
const char* getStrKey ()。获得元素的字符串键。
intptr_t getIntKey ()。获得元素的整型键。
Ref * getObject ()。获得元素中的值。
第②行代码CCDICT_FOREACH(dict1, pElement)是使用CCDICT_FOREACH宏对__Dictionary容器进行遍历的,宏的第一个参数dict1是__Dictionary 对象指针,第二个元素pElement是前面声明的__Dictionary元素(DictElement)指针。第③行代码 int key = pElement->getIntKey()获得元素的整型键。第④行代码Sprite* sprite = (Sprite*)pElement->getObject()获得元素中的值。
第⑤行代码CCDICT_FOREACH(dict2, pElement) )是遍历dict2对象。与dict1不同的是dict2使用的键是字符串类型,通过第⑥行代码const char *key = pElement->getStrKey()可以获得键。
HelloWorldScene.cpp中的析构函数代码如下:
- HelloWorld::~HelloWorld()
- {
- this->dict1->removeAllObjects();
- CC_SAFE_RELEASE_NULL(this->dict1);
- this->dict2->removeAllObjects();
- CC_SAFE_RELEASE_NULL(this->dict2);
- }
在析构函数中要释放一些资源,首先要移除容器中的所有元素,然后再通过CC_SAFE_RELEASE_NULL宏将容器对象先释放。
《Cocos2d-x实战 C++卷》现已上线,各大商店均已开售:
京东:http://item.jd.com/11584534.html
当当:http://product.dangdang.com/23606265.html
互动出版网:http://product.china-pub.com/3770734
《Cocos2d-x实战 C++卷》源码及样章下载地址:
源码下载地址:http://51work6.com/forum.php?mod=viewthread&tid=1155&extra=page%3D1
样章下载地址:http://51work6.com/forum.php?mod=viewthread&tid=1157&extra=page%3D1
相关推荐
Cocos2d-x实战_Lua卷 _第2版
Cocos2d-X_by_Example_Beginners_Guide[PDF版] 实例代码: Cocos2d-X_by_Example_Beginners_Guide[第三章代码] Cocos2d-X_by_Example_Beginners_Guide[第四章代码] Cocos2d-X_by_Example_Beginners_Guide[第五章...
资源名称:Cocos2d-x实战:JS卷——Cocos2d-JS开发内容简介:本书是介绍Cocos2d-x游戏编程和开发技术书籍,介绍了使用Cocos2d-JS中核心类、瓦片地图、物理引擎、音乐音效、数据持久化、网络通信、性能优化、多平台...
入门cocos2d-x不可多得的好资料,环境说明,工程搭配,实例教程
cocos2d-x实战_lua卷
资源名称:Cocos2d-x入门视频教程(全7讲)资源目录:【】cocos2d-x视频教程_01【】cocos2d-x视频教程_02【】cocos2d-x视频教程_03【】cocos2d-x视频教程_04【】cocos2d-x视频教程_05【】cocos2d-x视频教程_06【】...
cocos2d-x实战_js卷
cocos2d-x-2.1.5
谨记,该事件只能用于cocos2d-x中。 事件发送者需要继承EventDispatcher类 事件接收者需要继承EventHandle类,还需要实现handleEvent方法 事件发送者和事件接收者要在构造函数和析构函数中调用一下方法 事件发送者...
书中汇聚了热门手机游戏《捕鱼达人》开发的实战经验,作者从最基础的内容开始,逐步深入地介绍了Cocos2d-x的相关知识点。此外,书中的教学资源获得《捕鱼达人》手机游戏的授权,读者可以从一流游戏开发中高起点地...
资源名称:大富翁手机游戏开发实战基于Cocos2d-x3.2引擎内容简介:李德国编著的《大富翁手机游戏开发实战(基于 Cocos2d-x3.2引擎)》使用Cocos2d-x游戏引擎技术,带领读者一步一步从零开始进行大富翁移动游戏的开发...
精通COCOS2D-X游戏开发 精通COCOS2D-X游戏开发 精通COCOS2D-X游戏开发 精通COCOS2D-X游戏开发 精通COCOS2D-X游戏开发
俄罗斯方块cocos2d-x_1083源代码
cocos2d-x-3.2下载,不多说。或者可以下载另一个资源 cocos引擎老版本集合(cocos2d-x-2.2.1 - 3.5) http://download.csdn.net/download/crazymagicdc/9982656
详细介绍cocos2d-x vs2010 android cygwin 环境搭建,楼主亲测,如有疑问,可以私信我!
cocos2d-x实战项目 01.cocos2d-x原理及环境配置.rar 03.cocostudio使用方法及UI控制.rar 04.XML文件读取与骨骼动画.rarcocos2d-x实战项目 01.cocos2d-x原理及环境配置.rar 03.cocostudio使用方法及UI控制.rar 04.XML...
《Cocos2D-X游戏开发技术精解》详细介绍如何使用Cocos2D-X引擎开发自己的移动平台游戏。全书共15章,主要内容包括:Cocos2D-X引擎简介;如 资源太大,传百度网盘了,链接在附件中,有需要的同学自取。
cocos2d-x进阶教程1_4Lua中函数、条件判断语句.mp4 cocos2d-x进阶教程1_5Lua中循环语句和逻辑运算关键字.mp4 cocos2d-x进阶教程1_6LuaTable使用1.mp4 cocos2d-x进阶教程1_7LuaTable使用2.mp4 cocos2d-x进阶教程1_8...
ocos2d-x v3.16 安装流程文档 ocos2d-x v3.16 环境变量配置文档
Cocos2d-x_C++_3.4,48款游戏源码大合集,Demo 演示代码,简单实现:捕鱼达人,FlappyBird,2048,塔防,微信飞机,超级玛丽,坦克大战,刀塔传奇,防空-合金弹头,城市猎人(跑酷),封神,跑酷30,切水果,奇怪大冒险,翻牌效果,...