Cocos2d-x之Array

|   版权声明：本文为博主原创文章，未经博主允许不得转载。

　　Array是一个列表类容器，是一种线性序列结构；列表容器中的元素是有序的，可以通过下标来访问，就和数组一样。其中Vector也是一种列表容器，但是Array的缺陷是不能自动增长，而Vector却可以。

Array的创建函数：

 /** Creates an empty array. Default capacity is 10  创建_Array*/
    static __Array* create();
/** Create an array with objects 使用一系列Ref创建_Array*/
    static __Array* create(Ref* object, ...) CC_REQUIRES_NULL_TERMINATION;
/** Create an array with one object 使用一个Ref创建_Array*/
    static __Array* createWithObject(Ref* object);
/** Create an array with a default capacity创建_Array,并设置容量 */
    static __Array* createWithCapacity(ssize_t capacity);
/** Create an array with from an existing array 用一个已经存在的_Array来创建另一个_Array*/
    static __Array* createWithArray(__Array* otherArray);
/**     @brief   Generate a Array pointer by file，param   pFileName  The file name of *.plist file
return  The Array pointer generated from the file从属性列表文件创建_Array*/
    static __Array* createWithContentsOfFile(const std::string& pFileName);    
/*@brief The same meaning as arrayWithContentsOfFile(), but it doesn't call autorelease, so the
invoker should call release().*/
    static __Array* createWithContentsOfFileThreadSafe(const std::string& pFileName);

常用添加元素函数：

向_Array对象中添加元素都必须是Ref和其子类的对象指针类型。

/** Add a certain object 添加一个元素*/
    void addObject(Ref* object);
 /** Add all elements of an existing array 把一个已经存在的__Array对象中的所有元素添加到当前的__Array中*/
    void addObjectsFromArray(__Array* otherArray);
/** Insert a certain object at a certain index在指定的位置插入元素，ssize_t是int类型的别名*/
    void insertObject(Ref* object, ssize_t index);

常用移除函数：

/** Remove last object 移除最后一个元素*/
    void removeLastObject(bool releaseObj = true);
/** Remove a certain object 移除Array中的某个元素*/
    void removeObject(Ref* object, bool releaseObj = true);
/** Remove an element with a certain index 移除一个指定位置的元素*/
    void removeObjectAtIndex(ssize_t index, bool releaseObj = true);
/** Remove an objects 移除某个数组_Array对象*/
    void removeObjectsInArray(__Array* otherArray);
/** Remove all elements 移除所有的元素*/
    void removeAllObjects();
/** Fast way to remove a certain object 快速移除某个元素，把数组的最后一个元素(数值的最后一个远足是NULL)赋值给要删除的元素，但是要注意，这会改变原有与元素的顺序*/
    void fastRemoveObject(Ref* object);
/** Fast way to remove an element with a certain index 快速的移除某个指定位置的元素，与fastRemoveObject函数类似*/
    void fastRemoveObjectAtIndex(ssize_t index);

替换和交换元素的函数

/** Swap two elements 交换两个元素*/
    void exchangeObject(Ref* object1, Ref* object2);
/** Swap two elements with certain indexes 交换两个指定位置的元素*/
    void exchangeObjectAtIndex(ssize_t index1, ssize_t index2);
/** Replace object at index with another object. 用一个对象替代指定位置的元素*/
    void replaceObjectAtIndex(ssize_t index, Ref* object, bool releaseObject = true);

其他函数：

/** Revers the array 反转Array */
    void reverseObjects();
/**判断Array对象是否相等*/
    bool isEqualToArray(__Array* otherArray);
/** Returns a random element 随机返回元素*/
    Ref* getRandomObject();
/** Returns a Boolean value that indicates whether object is present in array.返回某个元素是否存在Array容器中*/
    bool containsObject(Ref* object) const;
/**统计Array的大小*/
    ssize_t count();

实例：

.h files

#ifndef _ARRAYTEST_SCENE_H_
#define _ARRAYTEST_SCENE_H_
#include "cocos2d.h"
class arrayTest : public cocos2d::Layer
{
private:
public:
	static cocos2d::Scene* createScene();
	virtual bool init();
	void arrTest();
	CREATE_FUNC(arrayTest);
};
#endif // _ARRAYTEST_SCENE_H_



.cpp files

#include "ArrayTest.h"
USING_NS_CC;
Scene* arrayTest::createScene()
{
	// 'scene' is an autorelease object
	auto scene = Scene::create();
	// 'layer' is an autorelease object
	auto layer = arrayTest::create();
	// add layer as a child to scene
	scene->addChild(layer);
	// return the scene
	return scene;
}
bool arrayTest::init()
{
	if (!Layer::init())
	{
		return false;
	}
	arrTest();
	return true;
}

void arrayTest::arrTest()
{
	//1.创建一个Array
	Array* arr = Array::create();

	//2.添加元素
	arr->addObject(String::create("I "));
	arr->addObject(String::create("love"));
	arr->addObject(String::create(" China!"));
	arr->addObject(String::create("values = 123456"));

	//3.获得大小
	int size = arr->count();
	CCLOG("The array size is : count = %d", size);
	for (int i = 0; i < size; i++)
	{
		String* e = (String*)arr->getObjectAtIndex(i);
		CCLOG("%s", e->getCString());
	}

	//4.根据索引获得某个元素
	String* elem = (String*)arr->getObjectAtIndex(2);
	CCLOG("%s", elem->getCString());

	//5.删除某个元素
	arr->removeObjectAtIndex(3);

	//6.遍历
	size = arr->count();
	for (int i = 0; i < size; i++)
	{
		String* e = (String*)arr->getObjectAtIndex(i);
		CCLOG("%s", e->getCString());
	}
}