1.概述
版本: v3.0 beta
语言: C++
class Value;
unioncocos2d::Valie 是一个包含了很多原生类型(int,float,double,bool,unsigned char,char* 和 std::string)外加 std::vector<Value>, std::unordered_map<std::string,Value> 和 std::unordered_map<int,Value> 的类。
你可以把所有上面的提及的原生类型放入 cocos2d::Value 对象中,然后将它们转化为对应的原生类型,反之亦然。
在内部,cocos2d::Value 使用了一个联合变量来保存各种原生类型,这样可以节省很多的内存空间。在 Cocos2d-x v3.0 beta 之前,存在着一些原生类型的封装类,如 CCBool, CCFloat, CCDouble, CCinteger,这些将会被弃用。注意:当你在处理原生类型和容器的时候,请使用 cocos2d::Vector<T>,cocos2d::Map<K,V> 和 cocos2d::Value。2.内存管理cocos2d::Value 的内存是由它自己的析构函数自动处理的。所以当处理 cocos2d::Value 的内存时请坚持以 c++ 内存管理规则进行最佳实践。cocos2d::Value 类包含了以下的数据成员:{ unsigned char byteVal; int intVal; float floatVal; double doubleVal; bool boolVal;}_baseData; std::string _strData;ValueVector* _vectorData;ValueMap* _mapData;ValueMapIntKey* _intKeyMapData; Type _type;
从代码片段可以看到,_baseData,_strData 和 _type 数据成员的内存是由编译器和她们的析构函数自动处理的。cocos2d::Value 的析构函数负责释放所有指针成员变量的资源(_vectorData,_mapData 和 _intKeyMapData)。
警告: cocos2d::Value 不再像其他的 cocos2d 类一样使用 retain/release和引用计数内存管理。3.基本用法cocos2d::Value 的用法是非常简单的。这里提供一个简单的示例:Value val; // 调用默认构造函数if(val.isNull()) { log("val is null");}else{ std::string str =val.getDescription(); log("The description of val0:%s",str.c_str());}//----------------------------------------------------Value val1(65); // 用一个 int 初始化//Value val1(3.4f); // 用一个 float 初始化//Value val1(3.5); // 用一个 double 初始化log("The description of the integer value:%s" ,val1.getDescription().c_str());log("val1.asByte() = %c" ,val1.asByte());//----------------------------------------------------std::string strV = "string";Value val2(strV); // 用 string 初始化log("The description of the string value:%s" ,val2.getDescription().c_str());//----------------------------------------------------auto sp0 = Sprite::create();Vector
输出:
cocos2d: val is nullcocos2d: The description of the integer value:65 cocos2d: val1.asByte() = Acocos2d: The description of the string value:string cocos2d: The description of the Vector value:true cocos2d: The description of the Map value:true cocos2d: The description of the Value-type value:true cocos2d: operator -> The description of val2:65 cocos2d: operator -> The description of val4:44.最佳实践
偏向于使用 cocos2d::Value 和新模版容器(cocos2d::Vector<T> 和 cocos2d::Map<K,V>)而不是使用 cocos2d::CCBool,cocos2d::CCFloat,cocos2d::CCDouble,cocos2d::CCString,cocos2d::CCInteger 和旧 Objective-c 风格容器(cocos2d::CCArray 和 cocos2d::CCDictionary)。
当你想要处理原生类型集合的时候,用 cocos2d::Value 封装原生类型,然后用新的模版容器 cocos2d::Vector<T> 和 cocos2d::Map<K,V> 组合它们。