Cocos2d-x中__Dictionary容器的使用详解

本文转载自：http://blog.csdn.net/tonny_guan/article/details/40022217

__Dictionary类在Cocos2d-x2.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(constchar*pFileName)。从属性列表文件创建__Dictionary。

2、添加元素

向__Dictionary对象中添加元素都必须是“键-值”对，“键”可以是字符串（std::string）类型或整数（signedint）类型，而“值”必须是Ref和其子类的对象指针类型。下面是总结常用的函数：

voidsetObject(Ref*pObject,conststd::string&key)。插入一个“键-值”对，其中pObject是“值”，key是“键”。如果是第一次调用，__Dictionary的“键”类型是字符串型，之后就不能插入整型“键”。如果已存在该“键”，则旧“键-值”对会被释放和移除，被新的替代。

-值”对，其中pObject是“值”，key是“键”,intptr_t类型是signedint类型的别名，为整型。如果是第一次调用，__Dictionary的“键”类型是整型，之后就不能插入字符串型“键”，如果已存在该“键”，则旧“键-值”对会被释放和移除，被新的替代。

3、移除元素

下面是总结常用的移除__Dictionary容器中元素的函数：

voidremoveObjectForKey(conststd::string&key)。通过指定键移除元素。

voidremoveObjectForKey(intptr_tkey)。通过指定键移除元素。

voidremoveObjectsForKeys(__Array*pKeyArray)。通过一个__Array中键集合移除元素。

voidremoveObjectForElememt(DictElement*pElement)。通过指定元素来移除。

voidremoveAllObjects()。移除所有的元素。

4、查找元素

我们还可以通过下面函数对__Dictionary容器中元素查找：

Ref*objectForKey(conststd::string&key)。返回指定字符串类型“键”的“值”。

Ref*objectForKey(intptr_tkey)。返回指定整型“键”的“值”。

const__String*valueForKey(conststd::string&key)。返回指定字符串类型“键”的“值”，返回值是__String指针类型，这里假定“值”是__String指针型，如果不是或者未找到，则返回空串。

const__String*valueForKey(intptr_tkey)。返回指定整型“键”的“值”，返回值是__String指针类型，这里假定“值”是__String指针，如果不是或者未找到，则返回空串。

5、其它操作函数

此外还有很多操作__Dictionary对象函数，下面是总结常用的函数：

__Array*allKeys()。返回一个包含所有“键”的“值”的__Array容器。

unsignedintcount()。返回元素个数。

boolwriteToFile(constchar*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代码如下：

[html] view plain copy

1. #ifndef__HELLOWORLD_SCENE_H__
2. #define__HELLOWORLD_SCENE_H__
4. #include"cocos2d.h"
5. #defineMAX_COUNT100①
6. classHelloWorld:publiccocos2d::Layer
7. {
8. cocos2d::__Dictionary*dict1;②
9. cocos2d::__Dictionary*dict2;③
11. public:
12. ~HelloWorld();④
13. staticcocos2d::Scene*createScene();
14. virtualboolinit();
15. voidmenuCloseCallback(cocos2d::Ref*pSender);
16. CREATE_FUNC(HelloWorld);
17. };
18. #endif//__HELLOWORLD_SCENE_H__

上述代码第①行代码#defineMAX_COUNT100定义宏MAX_COUNT，MAX_COUNT定义了一次生成的精灵数。第②和③行代码声明__Dictionary*的成员变量dict1和dict2。第④行代码是声明析构函数，我们需要在析构函数中释放成员变量dict1和dict2。

HelloWorldScene.cpp中的init函数代码如下：

copy