CCArray是从cocos2d中移植过来的,类似于Apple的NSMutableArray,但是比NSMutableArray更为的好用。要注意的是虽然CCArray和CCDictionary可以管理cocos2d-x中绝大多数的类,但是仍然无法替代STL库,STL库更为强有力。
1.API
先看一下CCArray可以帮我们做什么。
1.1.创建
1
2
3
4
5
6
7
8
9
10
|
//创建array
static
CCArray* create();
//使用一系列CCObject创建array
static
CCArray* create(CCObject* pObject, …);
//使用一个CCObject创建array
static
CCArray* createWithObject(CCObject* pObject);
//创建array并设置容量
static
CCArray* createWithCapacity(unsigned
int
capacity);
//用一个已存在的array创建另一个array
static
CCArray* createWithArray(CCArray* otherArray);
|
1.2.添加
1
2
3
4
5
6
|
//添加一个元素
void
addObject(CCObject* object);
//添加一个已存在array中所有元素
void
addObjectsFromArray(CCArray* otherArray);
//在指定位置插入元素
void
insertObject(CCObject* object, unsigned
int
index);
|
1.3.删除
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
//移除最后一个元素
void
removeLastObject(
bool
bReleaseObj =
true
);
//移除某个元素
void
removeObject(CCObject* object,
bool
bReleaseObj =
true
);
//移除一个指定位置的元素
void
removeObjectAtIndex(unsigned
int
index,
bool
bReleaseObj =
true
);
//移除某个array
void
removeObjectsInArray(CCArray* otherArray);
//移除所有元素
void
removeAllObjects();
//快速移除某个元素
void
fastRemoveObject(CCObject* object);
//快速移除某个指定位置的元素
void
fastRemoveObjectAtIndex(unsigned
int
index);
|
1.4.操作元素
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
//返回元素个数
unsigned
int
count()
const
;
//返回array容量
unsigned
int
capacity()
const
;
//返回指定CCObject的位置,如果不存在返回UINT_MAX
unsigned
int
indexOfObject(CCObject* object)
const
;
//返回指定位置的CCObject
CCObject* objectAtIndex(unsigned
int
index);
//返回最后一个元素
CCObject* lastObject();
//返回随机元素
CCObject* randomObject();
//返回某个元素是否存在于array中
bool
containsObject(CCObject* object)
const
;
//判断array是否相等
bool
isEqualToArray(CCArray* pOtherArray);
|
1.5.操作array内容
1
2
3
4
5
6
7
8
9
10
|
//交换2个元素
void
exchangeObject(CCObject* object1, CCObject* object2);
//交换2个指定位置元素
void
exchangeObjectAtIndex(unsigned
int
index1, unsigned
int
index2);
//用一个对象替代指定位置元素
void
replaceObjectAtIndex(unsigned
int
uIndex, CCObject* pObject,
bool
bReleaseObject =
true
);
//反转array
void
reverseObjects();
//收缩array内存以匹配元素个数
void
reduceMemoryFootprint();
|
2.remove和fastremove
从1.3可以看出删除有两种方式,普通删除和快速删除,它们有什么区别呢?
2.1.普通删除
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
//普通删除
void
ccArrayRemoveObjectAtIndex(ccArray *arr, unsigned
int
index,
bool
bReleaseObj
/* = true*/
)
{
CCAssert(arr && arr->num > 0 && index < arr->num,
"Invalid index. Out of bounds"
);
//删除元素内容,位置仍保留着
if
(bReleaseObj)
{
CC_SAFE_RELEASE(arr->arr[index]);
}
//长度减1
arr->num--;
//获得要删除的元素后的元素个数
unsigned
int
remaining = arr->num - index;
if
(remaining>0)
{
//将要删除元素后的所有元素逐个向前移动
memmove
((
void
*)&arr->arr[index], (
void
*)&arr->arr[index+1], remaining *
sizeof
(CCObject*));
}
}
|
2.2.快速删除
1
2
3
4
5
6
7
8
9
10
|
//快速删除
void
ccArrayFastRemoveObjectAtIndex(ccArray *arr, unsigned
int
index)
{
//删除元素内容,位置仍保留着
CC_SAFE_RELEASE(arr->arr[index]);
//获取最后一个元素
unsigned
int
last = --arr->num;
//把最后一个元素插到删除元素的位置上
arr->arr[index] = arr->arr[last];
}
|
2.3.总结
如果有array={0,1,2,3,4,5},如果要删除3,使用普通删除得到的结果{0,1,2,4,5},使用快速删除得到的结果是{0,1,2,5,4}。可以看出快速删除的效率比普通删除效率高,就差在移动元素的时间复杂度上。
3.内存分配
3.1.容量和个数
CCArray中容量和个数并不是同一个概念。个数<=容量。从添加元素的源码中可以看到在添加之前会先进行空间分配,所以它是一个动态分配内存的过程。如下
1
2
3
4
5
6
7
|
void
ccArrayEnsureExtraCapacity(ccArray *arr, unsigned
int
extra)
//确保有额外的空间
{
while
(arr->max < arr->num + extra)
//判断空间是否足够
{
ccArrayDoubleCapacity(arr);
//增加一倍空间
}
}
|
所以,每次CCArray在插入数据时检测到空间不足会增加一倍空间,再进行检测,直到空间满足分配为止。
3.2.判等
判断2个CCArray是否相等使用isEqualToArray(),判断相等的条件是CCArray中的每个元素相等即可,与CCArray的容量无关。
4.效率
比起NSMutableArray,CCArray效率能高出10%左右,原因有三:
(1)它使用的是C接口,所以它不有Objective-C消息开销。
(2)它假定你知道你在做什么,所以它不花时间在安全检查上(如边界溢出,空间需求等)。
(3)在比较上使用了指针而不是isEqual。
除了CCArray,我们还看到了ccCArray,CCArray基本上都是调用了ccCArray的函数,为什么要分为2种?
仔细看一下CCArray是继承于CCObject,所以CCArray是用于处理cocos2d-x对象的,内存管理上也有cocos2d-x的autorelease等诸多特性。而ccCArray可以直接操作标准的C数据结构和类型。
5.CCARRAY_FOREACH和CCARRAY_FOREACH_REVERSE
宏定义,用于正向遍历和反向遍历CCArray元素
1
2
3
4
5
6
7
8
9
10
11
|
#define CCARRAY_FOREACH(__array__, __object__) \
if
((__array__) && (__array__)->data->num > 0) \
for
(CCObject** __arr__ = (__array__)->data->arr, **__end__ = (__array__)->data->arr + (__array__)->data->num-1; \
__arr__ <= __end__ && (((__object__) = *__arr__) != NULL
/* || true*/
); \
__arr__++)
#define CCARRAY_FOREACH_REVERSE(__array__, __object__) \
if
((__array__) && (__array__)->data->num > 0) \
for
(CCObject** __arr__ = (__array__)->data->arr + (__array__)->data->num-1, **__end__ = (__array__)->data->arr; \
__arr__ >= __end__ && (((__object__) = *__arr__) != NULL
/* || true*/
); \
__arr__--)
|
6.示例
CCArray的使用示例在http://blog.csdn.net/jackystudio/article/details/11917875此文中有比较典型的应用,这里就不再详述。
7.注意
一般来说,CCArray不会被add到其他类,所以它的引用计数是1,而且被设置为自动释放。所以创建CCArray对象时要记得调用retain,而且在析构的时候也要调用release来释放内存。真心想吐槽。。。
FROM: http://blog.csdn.net/huanghuanghbc/article/details/25335369