Cocos2d-x中__Dictionary容器以及实例介绍

__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_COUNTMAX_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宏将容器对象先释放。

更多内容请关注最新Cocos图书《Cocos2d-x实战 C++卷》‍

本书交流讨论网站http://www.cocoagame.net

更多精彩视频课程请关注智捷课堂Cocos课程http://v.51work6.com

欢迎加入Cocos2d-x技术讨论群257760386
‍
《Cocos2d-x实战 C++卷》现已上线各大商店均已开售‍

京东http://item.jd.com/11584534.html

亚马逊http://www.amazon.cn/Cocos2d-x%E5%AE%9E%E6%88%98-C-%E5%8D%B7-%E5%85%B3%E4%B8%9C%E5%8D%87/dp/B00PTYWTLU

当当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 ‍

欢迎关注智捷iOS课堂微信公共平台

时间： 2024-03-31 18:32:03

Cocos2d-x中__Dictionary容器以及实例介绍的相关文章

Cocos2d-x中__Array容器以及实例介绍

__Array类在Cocos2d-x 2.x时代它就是CCArray类.它是模仿Objective-C中的NSArray类而设计的通过引用计数管理内存.__Array继承于Ref类因此它所能容纳的是Ref及子类所创建的对象指针. 1.创建__Array对象创建__Array对象有很多函数下面是总结常用的函数static __Array* create().创建__Array.static __Array* create(Ref* object, -).使用一系列Ref创建__Array.stat

Cocos2d-x中Vector&amp;lt;T&amp;gt;容器以及实例介绍

Vector<T> 是Cocos2d-x 3.x推出的列表容器因此它所能容纳的是Ref及子类所创建的对象指针其中的T是模板表示能够放入到容器中的类型在Cocos2d-x 3.x中T表示Ref类.Vector<T>是模仿C++的std::vector<T>模板类而设计的.在内存管理方面不使用__Array的引用计数它的内存管理是由编译器自动处理的可以不用考虑内存释放问题.Vector<T>的性能优于__Array类Coco2d-x官方将Vector<T&

实例介绍Cocos2d-x中Box2D物理引擎：HelloBox2D

我们通过一个实例介绍一下在Cocos2d-x 3.x中使用Box2D物理引擎的开发过程熟悉这些API的使用.这个实例运行后的场景如图所示当场景启动后玩家可以触摸点击屏幕每次触摸时候就会在触摸点生成一个新的精灵精灵的运行自由落体运动.   HelloBox2D实例使用Box2D引擎进行开发过程如图12-15所示.下面我们就按照这个步骤介绍一下代码部分.首先看一下看HelloWorldScene.h文件它的代码如下 #ifndef __HELLOWORLD_SCENE_H__ #define __H

生产环境中的容器之工作流

本文讲的是生产环境中的容器之工作流,[编者的话]很多公司已经在生产环境里大规模使用容器.前一篇文章里介绍了Spotify,DramaFever,Built.io和IIIEPE如何以及为什么使用容器.本文继续深入讨论这几个公司的工作流. 构建应用程序以及管理pull请求 在生产环境使用容器的一大吸引人之处是创建无缝的开发到生产环境的能力,最先代码在开发人员的笔记本上,然后能够整体移动到测试环境,并且随后直接部署,而不会因为底层基础架构环境的改动而导致问题. IIIEPE怎么做 Luis Elizo

实例介绍Cocos2d-x物理引擎：HelloPhysicsWorld

我们通过一个实例介绍一下在Cocos2d-x 3.x中使用物理引擎的开发过程熟悉这些API的使用.这个实例的运行后的场景当场景启动后玩家可以触摸点击屏幕每次触摸时候就会在触摸点生成一个新的精灵精灵的运行是自由落体运动. HelloPhysicsWorld实例 使用物理引擎的一般步骤如下图所示. 这个过程与上帝创建世界的过程类似上帝首先创建了世界然后为世界指定了边界否则万物就会掉到世界之外的混沌里去了最后上帝创建了万物.当然这只是一个最基本的步骤有的时候还需要碰撞检测和使用关节等处理.下面我们就按

实例介绍Cocos2d-x物理引擎：碰撞检测

碰撞检测是使用物理引擎的一个重要目的使用物理引擎可以进行精确的碰撞检测而且执行的效率也很高.在Cocos2d-x 3.x中使用事件派发机制管理碰撞事件EventListenerPhysicsContact是碰撞事件监听器.碰撞检测相关的API我们在前面一节介绍过了下面通过一个实例介绍碰撞检测的实现.这个实例的运行后的场景如图所示当场景启动后玩家可以触摸点击屏幕每次触摸时候就会在触摸点生成一个新的精灵精灵的运行是自由落体运动.当这些精灵之间发生接触时候它们的颜色被设置为黄色分离后颜色又恢复到原来状

Cocos2d-x开发实例介绍特效演示

下面我们通过一个实例介绍几个特效的使用这个实例下图所示下图是一个操作菜单场景选择菜单可以进入到下图动作场景在下图动作场景中点击Go按钮可以执行我们选择的特性动作点击Back按钮可以返回到菜单场景. 下面我们再看看具体的程序代码首先看一下看HelloWorldScene.h文件它的代码如下 #ifndef __HELLOWORLD_SCENE_H__ #define __HELLOWORLD_SCENE_H__ #include "cocos2d.h" #include "My

Cocos2d-x开发实例介绍帧动画使用

下面我们通过一个实例介绍一下帧动画的使用这个实例如下图所示点击Go按钮开始播放动画这时候播放按钮标题变为Stop点击Stop按钮可以停止播放动画. 下面我们再看看具体的程序代码首先看一下看HelloWorldScene.h文件它的代码如下 #ifndef __HELLOWORLD_SCENE_H__ #define __HELLOWORLD_SCENE_H__ #include "cocos2d.h" class HelloWorld : public cocos2d::Layer {

C++中vector的用法实例解析_C 语言

本文实例展示了C++中的vector用法,分享给大家供大家参考.具体如下: 一.概述 vector是C++标准模板库中的部分内容,它是一个多功能的,能够操作多种数据结构和算法的模板类和函数库.vector是一个容器,它能够存放各种类型的对象,简单地说,vector是一个能够存放任意类型的动态数组,可以动态改变大小. 例如: // c语言风格 int myHouse[100] ; // 采用vector vector<int> vecMyHouse(100); 当如上定义后,vecMyHouse