Cocos2d-x3.0模版容器详解之二：cocos2d::Map<K,V>

还在用CCDictionary吗？你out啦，来试试cocos2d::Map<K,V>吧。

1.概述

版本: v3.0 beta
语言: C++
定义在 “COCOS2DX_ROOT/cocos/base” 路径下的 "CCMap.h"
的头文件中。

?
cocos2d::Map<K,V> 是一个内部使用了 std::unordered_map的关联容器模版。
std::unordered_map 是一个存储了由key-value键值对组合成构成的关联性容器，允许基于键对单个元素进行快速检索。
在 unordered_map 中，key value 一般用来标识唯一的一个元素，而 mapped value 是一个对象，其内容关联到对于的 key value。
在内部，unordered_map 的元素并不依赖于 key 或者 mapped 值来使用任何的特定方式排序，而是取决于它们的哈希值，以便通过他们的key值快速访问单个元素（使用平均时间复杂度）。
在 Cocos2d-x v3.0 beta 之前，存在另一个顺序性容器 cocos2d::CCDictionary，这将会被弃用。
我们很细致地设计了 cocos2d::Map<K,V> 容器作为 cocos2d::CCDictionary 的替代品，所以请使用 cocos2d::Map 代替 cocos2d::CCDictionary。

2.模版参数

K - key value的类型.
unordered_map 中的每一个元素都由它的 key value 唯一标识。
V - mapped value的类型.
T 必须是一个指向 cocos2d::Object 子类对象的指针。不能是其他数据类型或者原生类型，因为我们已经将
Cocos2d-x 的内存管理模型集成到 cocos2d::Map<k,V> 中。

3.内存管理

cocos2d::Map<K,V> 类包含了唯一一个数据成员：
template <class K, class V>
class CC_DLL Map;
_data 的内存管理是由编译器自动处理的。如果你在栈上声明了一个 cocos2d::Map<K,V> 对象，那就不需要关心内存释放问题。
如果你调用了 new 操作符来分配一块 cocos2d::Map<K,V> 的动态内存，那就需要在使用完后调用 delete 操作符来释放内存。这同样适用于 new[] 和 delete[]。
注意：在新
C++ 中，它倾向于本地存储对象而不是堆存储对象。所以，请不要调用 new 操作符来分配 cocos2d::Map<K,V> 的堆对象，而是使用栈对象来代替。
如果你有足够的理由在堆上动态分配 cocos2d::Map<K,V> 的话，请使用智能指针替换原始指针，比如 Shared_ptr，unique_ptr。
警告：cocos2d::Map<K,V>
不再像其他的 cocos2d 类一样使用 retain/release和引用计数内存管理。

4.基本用法

警告： cocos2d::Map<K,V>
没有重载 operator[]，所以你不能使用像 map 这样的操作来试图从 cocos2d::Map<K,V> 获取元素。
更多 API 的使用，请参考引擎源码和 Cocos2d-x 3.0 beta 已实现的测试例。
这里提供一个简单的示例:

?
输出:

?
5.最佳实践

当将 cocos2d::Map<K, V>() 作为参数进行传递的时候，将它声明为一个常引用，如 const cocos2d::Map<K, V>()&。
T 必须是是一个指向 cocos2d::Object 子类对象的指针，不能是其他数据类型或者原生类型。