Cocos2d-x之Value

|   版权声明：本文为博主原创文章，未经博主允许不得转载。

　　Value类被称为包装类，它可以将int, float, bool, unsigned, har, char等，基本数据类型可以包装成为类，也包装一些c++标准类，如std::string,std::vector<Value>, std::unordered_map<std::string, Value> 和std::unordered<int, Value>。使用Value对象的好处是，封装的基本数据类型，可以使它们具有面向对象的特性，在另一方面，也可以便于数据类型之间的转换。（即：可以将Value类型转换成基本类型，也可以将基本类型转换成Value类型）。

API中的Value常用函数：

/** Create a Value by an unsigned char value. */
/**用无符号字符值创建一个值。*/
    explicit Value(unsigned char v);
    
/** Create a Value by an integer value. */
/**用整形值创建一个值。*/
    explicit Value(int v);
    
/** Create a Value by a float value. */
/**用浮点数值创建一个值。*/
    explicit Value(float v);
    
/** Create a Value by a double value. */
/**用双精度值创建一个值。*/
    explicit Value(double v);
    
/** Create a Value by a bool value. */
/**用bool（逻辑）值创建一个值。*/
    explicit Value(bool v);
    
/** Create a Value by a char pointer. It will copy the chars internally. */
/**用字符指针创建一个值。它将复制字符内部。*/
    explicit Value(const char* v);
    
/** Create a Value by a string. */
/**用字符串值创建一个值。*/
    explicit Value(const std::string& v);
    
/** Create a Value by a ValueVector object. */
/**通过valuevector对象创建一个值。*/
    explicit Value(const ValueVector& v);

/** Create a Value by a ValueVector object. It will use std::move internally. */
/**通过valuevector对象创建一个值。它将使用内部的std::move。 */
    explicit Value(ValueVector&& v);
    
/** Create a Value by a ValueMap object. */
/**由ValueMap对象创建一个值。 */
    explicit Value(const ValueMap& v);

/** Create a Value by a ValueMap object. It will use std::move internally. */
/**通过ValueMap对象创建一个值。它将使用内部的std::move。*/
    explicit Value(ValueMap&& v);
    
/** Create a Value by a ValueMapIntKey object. */
/**通过ValueMapIntKey对象创建一个值。*/
    explicit Value(const ValueMapIntKey& v);

/** Create a Value by a ValueMapIntKey object. It will use std::move internally. */
/**通过ValueMapIntKe对象创建一个值。它将使用内部的std::move。*/
    explicit Value(ValueMapIntKey&& v);

/** Gets as a byte value. Will convert to unsigned char if possible, or will trigger assert error.获取一个字节值。会如果有可能转换为unsigned char型，或会触发断言错误。 */
    unsigned char asByte() const;

/** Gets as an integer value. Will convert to integer if possible, or will trigger assert error. */
    int asInt() const;

/** Gets as a float value. Will convert to float if possible, or will trigger assert error. */
    float asFloat() const;

/** Gets as a double value. Will convert to double if possible, or will trigger assert error. */
    double asDouble() const;

/** Gets as a bool value. Will convert to bool if possible, or will trigger assert error. */
    bool asBool() const;

/** Gets as a string value. Will convert to string if possible, or will trigger assert error. */
    std::string asString() const;

/** Gets as a ValueVector reference. Will convert to ValueVector if possible, or will trigger assert error. */
    ValueVector& asValueVector();

/** Gets as a const ValueVector reference. Will convert to ValueVector if possible, or will trigger assert error. */
    const ValueVector& asValueVector() const;

/** Gets as a ValueMap reference.Will convert to ValueMap if possible, or will trigger assert error. */
    ValueMap& asValueMap();

/** Gets as a const ValueMap reference. Will convert to ValueMap if possible, or will trigger assert error. */
    const ValueMap& asValueMap() const;

/** Gets as a ValueMapIntKey reference. Will convert to ValueMapIntKey if possible, or will trigger assert error. 获取作为一个ValueMapinTKEY参考。会如果有可能转换为ValueMap TKEY，或会触发断言错误。*/
    ValueMapIntKey& asIntKeyMap();

/** Gets as a const ValueMapIntKey reference. Will convert to ValueMapIntKey if possible, or will trigger assert error.作为获取一个const值PrIntKey参考。会如果有可能转换为ValueMapIntKey，或会触发断言错误 */
    const ValueMapIntKey& asIntKeyMap() const;

 /** Checks if the Value is null.@return True if the Value is null, false if not.*/
    inline bool isNull() const { return _type == Type::NONE; }

实例：

.h files

#ifndef _VALUETEST_SCENE_H_
#define _VALUETEST_SCENE_H_
#include "cocos2d.h"
class valueTest : public cocos2d::Layer
{
private:
public:
	static cocos2d::Scene* createScene();
	virtual bool init();
	void valTest();
	CREATE_FUNC(valueTest);
};
#endif // _VALUETEST_SCENE_H_



.cpp files

val2.getDescription().c_str();这条语句的意思是，输出val2对象所描述的信息。
#include "ValueTest.h"
USING_NS_CC;
Scene* valueTest::createScene()
{
	// 'scene' is an autorelease object
	auto scene = Scene::create();
	// 'layer' is an autorelease object
	auto layer = valueTest::create();
	// add layer as a child to scene
	scene->addChild(layer);
	// return the scene
	return scene;
}
bool valueTest::init()
{
	if (!Layer::init())
	{
		return false;
	}
	valTest();
	return true;
}
void valueTest::valTest()
{
	//1. 调用默认的构造方法
	Value val;

	//2. 判断val是否为空
	if (val.isNull())
	{
		log("val is null");
	}
	else
	{
		std::string str = val.getDescription();
		log("The description of val: %s", str.c_str());
	}

	//3. 使用int初始化
	Value val1(65);
	log("The description of the int value: %s", val1.getDescription().c_str());
	log("Value.asBtye() = %c", val1.asByte());

	//4. 使用float初始化
	Value val2(3.1415f);
	log("The description of the float value: %s", val2.getDescription().c_str());
	log("Value.asBtye() = %c", val2.asByte());

	//5. 使用double初始化
	Value val3(3.1415967);
	log("The description of the integer value: %s", val3.getDescription().c_str());
	log("Value.asBtye() = %c", val3.asByte());

	//6. 使用字符串初始化
	std::string str1 = "china";
	Value val4(str1);
	log("The description of the string value: %s", val4.getDescription().c_str());

	//7. 使用Vector初始化
	auto spr = Sprite::create();
	Vector<Object*>* vec = new Vector<Object*>();
	vec->pushBack(spr);
	Value val5(vec);
	log("The discription of the Vector value: %s", val5.getDescription().c_str());
	delete vec;

	//8. 使用Map初始化
	Map<std::string, Object*>* map = new Map<std::string, Object*>();
	map->insert(str1, spr);
	//初始化map
	Value val6(map);
	log("The discription of the Map value:%s", val6.getDescription().c_str());
	delete map;
}