COCOS2D-3.9 Value接口分析

2DX 在3.2时没有引入 Value 概念，用于存放动态类型，实际值通过当时类型和值获取。

头文件中定义的几个类型和常量

typedef std::vector<Value> ValueVector;

存放 Value 类型的动态数组

typedef std::unordered_map<std::string, Value> ValueMap;

散列容器 string->Value

typedef std::unordered_map<int, Value> ValueMapIntKey;

散列容器 int->Value

针对上面的容器稍微有点看法：个人觉得RB的容器在数据量小的时候体现不出优势，但是 unordered_map 也不一定真的就比RB好

CC_DLL extern const ValueVector ValueVectorNull;

CC_DLL extern const ValueMap ValueMapNull;

CC_DLL extern const ValueMapIntKey ValueMapIntKeyNull;

这几个空容器没搞懂为啥

Value 中比较重要的两个结构。

枚举类型 Type , 分别用于表示 ：
NONE (空类型), BYTE(字节), INTEGER(整型), FLOAT(浮点数),DOUBLE(双精度), 
BOOLEAN(布尔), STRING(字符串), VECTOR(数组), MAP(StringKey), INT_KEY_MAP(IntKey)

枚举类型 Type _type; 字段表示当前实际类型。

联合体 _field 字段，分别用于存放对应类型的数据：
unsigned char byteVal(BYTE); int intVal(INTEGER); float floatVal(FLOAT); double doubleVal(DOUBLE); bool boolVal(BOOLEAN);
std::string* strVal(STRING); ValueVector* vectorVal(VECTOR); ValueMap* mapVal(MAP); ValueMapIntKey* intKeyMapVal(INT_KEY_MAP);

通过对应获取实际的值。

私有函数：

void clear();

通过当前类型清除当前类型的值，并将 _type 设置为 NONE

void reset(Type type);

设置当前类型，若类型没变则无操作，否则将清除，如果为指针类型，还将分配对象空间。

公共函数：

inline Type getType() const { return _type; }

获取当前类型

std::string getDescription() const;

获取描述，具体的值。

inline bool isNull() const { return _type == Type::NONE; }

获取类型是否可用

unsigned char asByte() const;

int asInt() const;

float asFloat() const;

double asDouble() const;

bool asBool() const;

返回基本类型的值

std::string asString() const;

将基本类型和字符串类型已字符串类型返回

特殊说明：基本类型和string之间会相互转换。也仅限为将当前值转换为指定值

ValueVector& asValueVector();

const ValueVector& asValueVector() const;

获取 ValueVector 引用或者常引用

ValueMap& asValueMap();

const ValueMap& asValueMap() const;

获取 ValueMap 引用或者常引用

ValueMapIntKey& asIntKeyMap();

const ValueMapIntKey& asIntKeyMap() const;

获取 ValueMapIntKey 引用或者常引用

bool operator!= (const Value& v);

bool operator!= (const Value& v) const;

bool operator== (const Value& v);

bool operator== (const Value& v) const;

等于不等于的操作符重载。

Value& operator= (const Value& other);

Value& operator= (Value&& other);

Value& operator= (unsigned char v);

Value& operator= (int v);

Value& operator= (float v);

Value& operator= (double v);

Value& operator= (bool v);

Value& operator= (const char* v);

Value& operator= (const std::string& v);

Value& operator= (const ValueVector& v);

Value& operator= (ValueVector&& v);

Value& operator= (const ValueMap& v);

Value& operator= (ValueMap&& v);

Value& operator= (const ValueMapIntKey& v);

Value& operator= (ValueMapIntKey&& v);

操作符 = 重载，用于赋值一个 Value 对象，指定对应的类型和值，右值引用和一般引用没多大区别，需要注意变量生命周期

Value();

explicit Value(unsigned char v);

explicit Value(int v);

explicit Value(float v);

explicit Value(double v);

explicit Value(bool v);

explicit Value(const char* v);

explicit Value(const std::string& v);

explicit Value(const ValueVector& v);

explicit Value(ValueVector&& v);

explicit Value(const ValueMap& v);

explicit Value(ValueMap&& v);

explicit Value(const ValueMapIntKey& v);

explicit Value(ValueMapIntKey&& v);

Value(const Value& other);

Value(Value&& other);

构造函数、复制构造函数， explicit 防止隐式转换。

静态变量：

static const Value Null;

没发现作用，除了一个空对象