学步园

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>设计为__Array的替代品，推荐使用Vector<T>类。

1、创建Vector对象

创建Vector对象有很多函数，下面是总结常用的函数：

 Vector()。默认的构造函数。

 Vector(ssize_t capacity)。创建Vector对象，并设置容量。

 Vector(const Vector<T> &other) 。用一个已存在的Vector对象创建另一个Vector对象，其中&other是左值引用参数传递。

 Vector(Vector<T> &&other) 。用一个已存在的Vector对象创建另一个Vector对象，其中&&other是右值引用参数传递。

提示  左值与右值？C++中所有的表达式和变量要么是左值，要么是右值。左值的定义就是非临时变量，可以在多条语句中使用的变量。右值是指临时的变量，它们只在当前的语句中有效。例如在语句int i = 0;中i为左值，0位右值。左值与右值还可以出现在函数参数列表中,即左值引用（&）和右值引用（&&），如下代码所示。

void process_value(int& i) {  //& i表示左值引用

  std::cout << "左值引用: " << i << std::endl; 

} 

void process_value(int&& i) {   //&& i表示右值引用

  std::cout << "右值引用: " << i << std::endl; 

} 

int main() { 

  int a = 0; 

  process_value(a);  //调用void process_value(int& i)函数

  process_value(1);  //调用void process_value(int&& i)函数

}

2、添加元素

向Vector对象中添加元素都必须是Ref对象指针类型，下面是总结常用的函数：

void pushBack(T object) 。添加一个元素，T表示Ref对象指针类型。

 void pushBack(const Vector<T> &other)。把一个Vector对象中所有元素添加到当前Vector对象中。 

 void insert(ssize_t index, T object) 。在指定位置插入元素，ssize_t是int类型别名。

3、移除元素

下面是总结常用的移除Vector<T>容器中元素的函数：

void popBack()。移除最后一个元素。

 void eraseObject(T object, bool removeAll=false)。移除某个元素。 

iterator erase(iterator position)。指定位置移除对象，参数是迭代器，而返回值是下一个迭代器。

iterator erase(iterator first, iterator last)。指定移除对象范围（first~last），参数是迭代器，而返回值是下一个迭代器。

 iterator erase(ssize_t index)。移除一个指定索引的元素，参数是ssize_t，而返回值是下一个迭代器。

 void clear ()。移除所有元素。

4、替换和交换元素

我们还可以通过下面函数对Vector容器中元素替换和交换：

 void swap(T object1, T object2)。交换2个元素。 

 void swap(ssize_t index1, ssize_t index2)。交换2个指定位置元素。 

void replace(ssize_t index, T object)。用一个对象替代指定位置元素。

5、查找操作

我们有的时候还需要操作Vector中的元素，下面是总结常用的查找函数：

 iterator find (T object)。查找Vector容器中的对象，返回值迭代器。 

T at(ssize_t index)。根据索引位置返回Vector容器中的元素。

T front()。返回第一个元素。

T back ()。返回最后一个元素。

T getRandomObject()。返回随机元素。

bool contains(T object)。返回某个元素是否存在容器中。

ssize_t getIndex (T object)。返回指定对象的位置。

6、其它操作函数

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

ssize_t size ()。返回元素个数。 

ssize_t capacity()。返回Vector的容量。 

实例：Vector容器

为了熟悉Vector类的主要函数，下面我们将13.2.2一节的实例通过Vector列表容器实现一下。如图13-3所示场景，点击右下角的Go按钮，在场景中添加100个精灵。

下面我们看看代码部分，HelloWorldScene.h代码如下： 

#ifndef __HELLOWORLD_SCENE_H__
#define __HELLOWORLD_SCENE_H__
 
#include "cocos2d.h"
 
#define MAX_COUNT 100
 
class HelloWorld : public cocos2d::Layer
{
cocos2d::Vector<cocos2d::Sprite*> list;	①
public:
    static cocos2d::Scene* createScene();
 
    virtual bool init();  
    
    void menuCloseCallback(cocos2d::Ref* pSender);
    
    CREATE_FUNC(HelloWorld);
};
 
#endif // __HELLOWORLD_SCENE_H__

上述代码与13.2.2一节实例比较，我们将list成员变量类型换成了cocos2d::Vector<cocos2d::Sprite*>，见第①行代码所示。注意我们不再需要析构函数声明了，使用Vector比较方便的是内存管理由编译器自动处理的系统。

HelloWorldScene.cpp中的主要代码如下：

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->list = Vector<Sprite*>(MAX_COUNT);	①
 
for(int i = 0;i < MAX_COUNT; ++i){	②
Sprite* sprite = Sprite::create("Ball.png");
this->list.pushBack(sprite);	③
}
 
return true;
}
 
 
void HelloWorld::menuCloseCallback(Ref* pSender)
{
Ref* obj = nullptr;
log("List count = %d",this->list.size());
Size visibleSize = Director::getInstance()->getVisibleSize();
 
for(const auto& sprite : this->list)	④
{
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);
}
 
}

上述代码第①行this->list = Vector<Sprite*>(MAX_COUNT)是创建Vector 类型的list成员变量，并指定Vector容器内存放的是Sprite指针类型，Vector构造函数参数是容器的初始化容量。第②行代码进行for循环创建100个精灵对象。第③行代码this->list.pushBack(sprite)是将精灵对象添加到list容器对象中，pushBack是Vector通过的添加元素函数，由于在第①行设置list容器的模板为Sprite指针，所以pushBack函数只能放过Sprite和其子类指针类型。

第④行代码for(const auto& sprite : this->list){…}是循环遍历list容器对象，这里使用的循环是C++11规范的新功能range-based for loops，range-based for loops被翻译为“序列for循环语句”，序列for循环语句允许重复遍历一组序列，而这组序列可以是任何可以重复遍历的序列，所有C++标准容器数据容器都可用作这种序列。for中声明引用类型（auto&）可以便于在循环体中修改元素，声明为const auto&可以提高执行的效率。

提示  在遍历Vector容器时候还可以使用C++中迭代器进行遍历，参看代码如下。Vector中定义了相关的begin()和end()函数。

for (Vector<Sprite*>::const_iterator it = this->list.begin(); it != this->list.end(); ++it)
{
int x = CCRANDOM_0_1() * visibleSize.width;
int y = CCRANDOM_0_1() * visibleSize.height;
Sprite* sprite = *it;	//解引用操作符（*操作符）来访问迭代器所指向元素
 
sprite->setPosition( Vec2(x, y) );
this->removeChild(sprite);
this->addChild(sprite);
}