[Cocos2d-x v3.x]cocos2d::Value

文章转载于: http://www.cocoachina.com/gamedev/cocos/2014/0604/8672.html

于v3.0beta加入

定义在"COCOS2DX_ROOT/cocos/base"的头文件"CCValue.h"中

class Value; 

cocos2d::Value是许多基本类型(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.0beta之前使用的是CCBool, CCFloat, CCDouble和CCInteger这样基本类型包装类，不过它们将被废弃掉。
 
注意：当处理基本类型和和容器时，请使用cocos2d::Vector<T>, cocos2d::Map<K,V>和cocos2d::Value。
 
内存管理
cocos2d::Value的内存由它的析构函数来释放，所以使用cocos2d::Value时请尽量用推荐的最佳做法。
 
cocos2d::Value包含下面的数据成员：
 
union {     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和refcount内存管理
 
基本用法
cocos2d::Value的用法非常简单直接。 下面就是使用的例子：
  
Value val;   // call the default constructor 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);   // initialize with a integer //Value val1(3.4f);   // initialize with a float value //Value val1(3.5);   // initialize with a double value 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);   // initialize with string log("The description of the string value:%s",val2.getDescription().c_str()); //---------------------------------------------------- auto sp0 = Sprite::create(); Vector<Object*>* vecV = new Vector<Object*>(); vecV->pushBack(sp0); Value val3(vecV);   // initialize with Vector log("The description of the Vector value:%s",val3.getDescription().c_str()); delete vecV; //---------------------------------------------------- Map<std::string, Object*>* mapV = new Map<std::string, Object*>(); mapV->insert(strV,sp0); Value val4(mapV);   // initialize with Map log("The description of the Map value:%s",val4.getDescription().c_str()); delete mapV; //---------------------------------------------------- Value val6(&val4);   // initialize with Map log("The description of the Value-type value:%s",val6.getDescription().c_str()); //---------------------------------------------------- val2 = val1;   // assigning between 2 Value-type log("operator-> The description of val2:%s",val2.getDescription().c_str()); val2 = 4;   //assigning directly log("operator-> The description of val4:%s",val2.getDescription().c_str());  结果是：cocos2d: val is null cocos2d: The description of the integer value: 65   cocos2d: val1.asByte() = A cocos2d: 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: 4 

最佳用法
1. 考虑使用cocos2d::Value和新的模版容器(cocos2d::Vector和cocos2d::Map)优于使用cocos2d::CCBool, cocos2d::CCFloat,cocos2d::CCDouble,cocos2d::CCString,cocos2d::CCInteger和旧的objective-c风格的容器(cocos2d::CCArray和cocos2d::CCDictionary)。
 
2. 当要使用基本类型的聚合时，将基本类型包装成cocos2d::Value，然后将它们和模版容器cocos2d::Vector和cocos2d::Map联合使用。