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

__Array类在Cocos2d-x 2.x时代它就是CCArray类。它是模仿Objective-C中的NSArray类而设计的，经过引用计数管理内存。__Array继承于Ref类，所以它所能容纳的是Ref及子类所建立的对象指针。


一、建立__Array对象
建立__Array对象有不少函数，下面是总结经常使用的函数：
static __Array* create()。建立__Array。
static __Array* create(Ref* object, …)。使用一系列Ref建立__Array。
static __Array* createWithObject(Ref * object)。使用一个Ref建立__Array。 
static __Array* createWithCapacity(unsigned int capacity)。建立__Array，并设置容量。
static __Array* createWith__Array(__Array* other__Array)。用一个已存在的__Array建立另外一个__Array。 
static __Array* createWithContentsOfFile(const std::string &pFileName) 。从属性列表文件建立__Array。  


二、添加元素
向__Array对象中添加元素都必须是Ref和其子类的对象指针类型，下面是总结经常使用的函数：
void addObject(Ref* object)。添加一个元素。  
void addObjectsFromArray(__Array* otherArray)。把一个__Array对象中全部元素添加到当前__Array对象中。
void insertObject(Ref* object, ssize_t index)。在指定位置插入元素，ssize_t是int类型别名。


三、移除元素
下面是总结经常使用的移除__Array容器中元素的函数：
void removeLastObject()。移除最后一个元素。
void removeObject(Ref* object)。移除某个元素。  
void removeObjectAtIndex(ssize_t index)。移除一个指定位置的元素。
void removeObjectsInArray(__Array* otherArray)。移除某个数组__Array对象。 
void removeAllObjects()。移除全部元素。 
void fastRemoveObject(Ref* object)。快速移除某个元素。 
void fastRemoveObjectAtIndex(ssize_t index)。快速移除某个指定位置的元素。


四、替换和交换元素
咱们还能够经过下面函数对__Array容器中元素替换和交换：
void exchangeObject(Ref* object1, Ref* object2)。交换2个元素。 
void exchangeObjectAtIndex(ssize_t index1, ssize_t index2)。交换2个指定位置元素。 
void replaceObjectAtIndex(ssize_t uIndex, Ref* object)。用一个对象替代指定位置元素。


五、其它操做函数
此外还有不少操做__Array对象的函数，下面是总结经常使用的函数：
ssize_t count()。返回元素个数。 
ssize_t capacity()。返回__Array的容量。 
ssize_t indexOfObject(Ref* object)。返回指定Ref对象指针的位置。
Ref* objectAtIndex(ssize_t index)。返回指定位置的Ref对象指针。
Ref* lastObject()。返回最后一个元素。 
Ref* randomObject()。返回随机元素。 
bool containsObject(Ref* object)。返回某个元素是否存在于__Array容器中。
bool isEqualToArray(__Array* pOtherArray)。判断__Array对象是否相等。 
void reverseObjects()。反转__Array容器。 


六、遍历__Array容器
Cocos2d-x提供了两个遍历__Array容器的宏：
CCARRAY_FOREACH。正向遍历。
CCARRAY_FOREACH_REVERSE。反向遍历。


实例：__Array容器
下面咱们经过一个实例介绍__Array容器中的相关函数。如图所示场景，点击右下角的Go按钮，在场景中添加100个精灵。 

__Array容器实例

要实现上述功能咱们能够不使用__Array，可是为了熟悉__Array类，咱们在本例实现中特地使用了__Array类。
下面咱们看看代码部分，HelloWorldScene.h代码以下： 

[html] view plaincopy

1. #ifndef __HELLOWORLD_SCENE_H__  

2. #define __HELLOWORLD_SCENE_H__  

3.   

4.   

5. #include "cocos2d.h"  

6.   

7.   

8. #define MAX_COUNT 100                                               ①  

9.   

10.   

11. class HelloWorld : public cocos2d::Layer  

12. {  

13.     cocos2d::__Array* list;                                             ②  

14. public:  

15.   

16.   

17.     ~HelloWorld();                                                      ③  

18.     static cocos2d::Scene* createScene();  

19.     virtual bool init();    

20.       

21.     void menuCloseCallback(cocos2d::Ref* pSender);  

22.       

23.     CREATE_FUNC(HelloWorld);  

24. };  

25.   

26.   

27. #endif // __HELLOWORLD_SCENE_H__  

上述代码第①行代码#define MAX_COUNT 100定义宏MAX_COUNT，MAX_COUNT定义了一次生成的精灵数。第②行代码声明__Array*的成员变量list。第③行代码是声明析构函数，咱们须要在析构函数中释放成员变量list。
HelloWorldScene.cpp中的init函数代码以下：

[html] view plaincopy

1. bool HelloWorld::init()  

2. {  

3.     if ( !Layer::init() )  

4.     {  

5.         return false;  

6.     }  

7.   

8.   

9.     Size visibleSize = Director::getInstance()->getVisibleSize();  

10.     Vec2 origin = Director::getInstance()->getVisibleOrigin();  

11.   

12.   

13.     auto goItem = MenuItemImage::create(  

14.         "go-down.png",  

15.         "go-up.png",  

16.         CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));  

17.   

18.   

19.     goItem->setPosition(Vec2(origin.x + visibleSize.width - goItem->getContentSize().width/2 ,  

20.         origin.y + goItem->getContentSize().height/2));  

21.   

22.   

23.     auto menu = Menu::create(goItem, NULL);  

24.     menu->setPosition(Vec2::ZERO);  

25.     this->addChild(menu, 1);  

26.   

27.   

28.     this->list  = __Array::createWithCapacity(MAX_COUNT);                            ①  

29.     this->list->retain();                                                 ②  

30.   

31.   

32.     for(int i = 0;i < MAX_COUNT; ++i){                                         

33.         Sprite* sprite = Sprite::create("Ball.png");                                    ③  

34.         this->list->addObject(sprite);                                            ④  

35.     }  

36.   

37.   

38.     return true;  

39. }  

init是初始化场景的函数，咱们在该函数中建立了100个精灵，并把它们放到__Array*类型的list成员变量中。其中第①行代码是建立__Array*类型的list成员变量，使用createWithCapacity函数，其中的参数是list容器的初始化容量。第②行代码this->list->retain()很是重要，采用静态函数createWithCapacity建立的list容器对象是autorelease的，若是不调用retain()函数保持内存，当init函数结束时候，list容器对象会自动释放，这样在其它函数中再使用list容器对象就会出错。第③行代码是循环建立精灵对象，第④行代码是将精灵添加到list容器对象中，可是须要注意的是这些精灵对象尚未被添加到场景中，所以，场景显示的时候它们是不出现的。
HelloWorldScene.cpp中的menuCloseCallback函数代码以下：

[html] view plaincopy

1. void HelloWorld::menuCloseCallback(Ref* pSender)  

2. {  

3.       

4.     log("list->count() = %d",this->list->count());  

5.     Size visibleSize = Director::getInstance()->getVisibleSize();  

6.   

7.   

8.     Ref* obj = nullptr;  

9.   

10.   

11.     CCARRAY_FOREACH(this->list, obj) {                                       ①  

12.           

13.         Sprite* sprite = (Sprite*)obj;                                          ②  

14.   

15.   

16.         int x = CCRANDOM_0_1() * visibleSize.width;                             ③  

17.         int y = CCRANDOM_0_1() * visibleSize.height;                                ④  

18.   

19.   

20.         sprite->setPosition( Vec2(x, y) );  

21.         this->removeChild(sprite);  

22.         this->addChild(sprite);  

23.     }  

24.   

25.   

26. }  

该函数是在玩家触摸Go按钮以后调用的函数，其中第①行代码是使用CCARRAY_FOREACH宏，循环遍历list容器中的数据。第②行代码是Sprite* sprite = (Sprite*)obj得到精灵对象。第③行代码CCRANDOM_0_1() * visibleSize.width是随机产生x轴坐标，CCRANDOM_0_1()是产生0~1之间的随机数的宏。相似第④行代码是随机产生精灵的y轴坐标。
HelloWorldScene.cpp中的析构函数代码以下：

[html] view plaincopy

1. HelloWorld::~HelloWorld()  

2. {  

3.     this->list->removeAllObjects();                                           ①  

4.     CC_SAFE_RELEASE_NULL(this->list);                                        ②  

5. }  

在析构函数中要释放一些资源，第①行代码this->list->removeAllObjects()是移除list容器中的全部对象，可是这尚未释放list容器对象自己。第②行代码CC_SAFE_RELEASE_NULL(this->list)是安全释放成员变量list容器对象。其中的CC_SAFE_RELEASE_NULL是将list容器对象先释放，而后再赋予nullptr。

更多内容请关注国内第一本Cocos2d-x 3.2版本图书《Cocos2d-x实战：C++卷》

本书交流讨论网站：http://www.cocoagame.net
更多精彩视频课程请关注智捷课堂Cocos课程：http://v.51work6.com

欢迎加入Cocos2d-x技术讨论群：257760386

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