| 版权声明:本文为博主原创文章,未经博主允许不得转载。
FileUtils
在游戏中,用户要保存自己的偏好设置和玩家的信息,都需要涉及到游戏数据的处理。首先要想处理数据,则要找到文件,创建文件,读写文件...;在Cocos2d-x中有一个类FileUtils,FileUtils是Cocos2d-x引擎中封装的一个简单的文件操作类,该类几乎实现了所有文件操作的功能,类FileUtils并不只是一个文件,也不是两个文件。在每个平台都会有一个FileUtils的头文件和实现文件。在游戏的开始阶段,游戏的文件资源一般都是存放在硬盘中,在游戏开始的时候,文件操作模块就会将硬盘中的资源转移到内存中。
在游戏中文件的读取分为三个部分:
1. 资源存放在硬盘中
2. 资源存放在内存中
3. 资源存放在缓存中
API常用函数介绍:
1 /** Gets the instance of FileUtils.获得文件模块的单例对象 */ 2 static FileUtils* getInstance(); 3 /** Destroys the instance of FileUtils.释放文件模块*/ 4 static void destroyInstance(); 5 /** 清空缓存 6 * Purges full path caches. 7 */ 8 virtual void purgeCachedEntries(); 9 /** 从文件中获取字符串。 10 * Gets string from a file. 11 */ 12 virtual std::string getStringFromFile(const std::string& filename); 13 /** 获得资源文件的内容 14 * Creates binary data from a file. 15 * @return A data object. 16 */ 17 virtual Data getDataFromFile(const std::string& filename); 18 /** 获取资源文件数据 19 * Gets resource file data 20 * @param[in] filename The resource file name which contains the path. 21 * @param[in] mode The read mode of the file. 22 * @param[out] size If the file read operation succeeds, it will be the data size, otherwise 0. 23 * @return Upon success, a pointer to the data is returned, otherwise NULL. 24 * @warning Recall: you are responsible for calling free() on any Non-NULL pointer returned. 25 */ 26 CC_DEPRECATED_ATTRIBUTE virtual unsigned char* getFileData(const std::string& filename, const char* mode, ssize_t *size); 27 /** 从zip文件中获得资源文件的内容 28 * Gets resource file data from a zip file. 29 * @param[in] filename The resource file name which contains the relative path of the zip file. 30 * @param[out] size If the file read operation succeeds, it will be the data size, otherwise 0. 31 * @return Upon success, a pointer to the data is returned, otherwise nullptr. 32 * @warning Recall: you are responsible for calling free() on any Non-nullptr pointer returned. 33 */ 34 virtual unsigned char* getFileDataFromZip(const std::string& zipFilePath, const std::string& filename, ssize_t *size); 35 /** 获得一个文件的绝对路径,返回值为文件的绝对路径(通过文件名查找文件,并将它所在的路径返回) 36 * Returns the fullpath for a given filename. 37 */ 38 virtual std::string fullPathForFilename(const std::string &filename) const; 39 /** 通过一个文件名在字典容器中查找文件 40 * Loads the filenameLookup dictionary from the contents of a filename. 41 * @note The plist file name should follow the format below: 42 */ 43 virtual void loadFilenameLookupDictionaryFromFile(const std::string &filename); 44 /** 设置一个按文件名查找的字典。 45 * Sets the filenameLookup dictionary. 46 * @param pFilenameLookupDict The dictionary for replacing filename. 47 */ 48 virtual void setFilenameLookupDictionary(const ValueMap& filenameLookupDict); 49 /** 获得一个文件的绝对路径包含文件名 50 * Gets full path from a file name and the path of the relative file. 51 */ 52 virtual std::string fullPathFromRelativeFile(const std::string &filename, const std::string &relativeFile); 53 /** 设置数组容器内所包含的资源的搜索顺序。 54 * Sets the array that contains the search order of the resources. 55 * @param searchResolutionsOrder The source array that contains the search order of the resources. 56 * @see getSearchResolutionsOrder(), fullPathForFilename(const char*). 57 */ 58 virtual void setSearchResolutionsOrder(const std::vector<std::string>& searchResolutionsOrder); 59 /** 追加资源的搜索顺序。 60 * Append search order of the resources. 61 * @see setSearchResolutionsOrder(), fullPathForFilename(). 62 */ 63 virtual void addSearchResolutionsOrder(const std::string &order,const bool front=false); 64 /** 获取数组中所包含的资源的搜索顺序 65 * Gets the array that contains the search order of the resources. 66 * @see setSearchResolutionsOrder(const std::vector<std::string>&), fullPathForFilename(const char*). 67 */ 68 virtual const std::vector<std::string>& getSearchResolutionsOrder() const; 69 /** 设置资源路径 70 * Sets the array of search paths. 71 */ 72 virtual void setSearchPaths(const std::vector<std::string>& searchPaths); 73 /** 设置默认资源的根路径。 74 * Set default resource root path. 75 */ 76 void setDefaultResourceRootPath(const std::string& path); 77 /** 添加搜索路径。 78 * Add search path. 79 */ 80 void addSearchPath(const std::string & path, const bool front=false); 81 /** 获取的搜索路径的数组。 82 * Gets the array of search paths. 83 */ 84 virtual const std::vector<std::string>& getSearchPaths() const; 85 /** 获取可写的路径。 86 * Gets the writable path. 87 * @return The path that can be write/read a file in 88 */ 89 virtual std::string getWritablePath() const = 0; 90 /** 设置可写的路径。 91 * Sets writable path. 92 */ 93 virtual void setWritablePath(const std::string& writablePath); 94 /** 设置在无法加载图像时候是否弹出一个消息框。 95 * Sets whether to pop-up a message box when failed to load an image. 96 */ 97 virtual void setPopupNotify(bool notify); 98 /** 检查在无法加载图像的时候是否弹出一个消息框。 99 * Checks whether to pop up a message box when failed to load an image. 100 * @return True if pop up a message box when failed to load an image, false if not. 101 */ 102 virtual bool isPopupNotify() const; 103 /** 文件到ValueMap的内容转换。(将文件中的内容转换成ValueMap类型) 104 * Converts the contents of a file to a ValueMap. 105 * @param filename The filename of the file to gets content. 106 * @return ValueMap of the file contents. 107 * @note This method is used internally. 108 */ 109 virtual ValueMap getValueMapFromFile(const std::string& filename); 110 /** Converts the contents of a file to a ValueMap. 111 * This method is used internally. 112 */ 113 virtual ValueMap getValueMapFromData(const char* filedata, int filesize); 114 /** 写一个内容为ValueMap类型的plist文件 115 * write a ValueMap into a plist file 116 *@param dict the ValueMap want to save 117 *@param fullPath The full path to the file you want to save a string 118 *@return bool 119 */ 120 virtual bool writeToFile(ValueMap& dict, const std::string& fullPath); 121 /** 写一个内容为String类型的.plist文件 122 * write a string into a file 123 * @param dataStr the string want to save 124 * @param fullPath The full path to the file you want to save a string 125 * @return bool True if write success 126 */ 127 virtual bool writeStringToFile(std::string dataStr, const std::string& fullPath); 128 /** 129 * write Data into a file 130 *@param retData the data want to save 131 *@param fullPath The full path to the file you want to save a string 132 *@return bool 133 */ 134 virtual bool writeDataToFile(Data retData, const std::string& fullPath); 135 /** 136 * write ValueMap into a plist file 137 *@param dict the ValueMap want to save 138 *@param fullPath The full path to the file you want to save a string 139 *@return bool 140 */ 141 virtual bool writeValueMapToFile(ValueMap& dict, const std::string& fullPath); 142 /** 143 * write ValueVector into a plist file 144 *@param vecData the ValueVector want to save 145 *@param fullPath The full path to the file you want to save a string 146 *@return bool 147 */ 148 virtual bool writeValueVectorToFile(ValueVector vecData, const std::string& fullPath); 149 /** 150 * Windows fopen can't support UTF-8 filename 151 * Need convert all parameters fopen and other 3rd-party libs 152 * @param filename std::string name file for conversion from utf-8 153 * @return std::string ansi filename in current locale 154 */ 155 virtual std::string getSuitableFOpen(const std::string& filenameUtf8) const; 156 // Converts the contents of a file to a ValueVector. 157 // This method is used internally. 158 virtual ValueVector getValueVectorFromFile(const std::string& filename); 159 /** 判断文件是否存在 160 * Checks whether a file exists. 161 * @note If a relative path was passed in, it will be inserted a default root path at the beginning. 162 * @param filename The path of the file, it could be a relative or absolute path. 163 * @return True if the file exists, false if not. 164 */ 165 virtual bool isFileExist(const std::string& filename) const; 166 /** 获取文件的扩展名是在较低的情况下的后缀(由点从基本文件名隔开)。 167 * Gets filename extension is a suffix (separated from the base filename by a dot) in lower case. 168 * Examples of filename extensions are .png, .jpeg, .exe, .dmg and .txt. 169 * @param filePath The path of the file, it could be a relative or absolute path. 170 * @return suffix for filename in lower case or empty if a dot not found. 171 */ 172 virtual std::string getFileExtension(const std::string& filePath) const; 173 /** 检查路径是否是绝对路径。 174 * Checks whether the path is an absolute path.t. 175 */ 176 virtual bool isAbsolutePath(const std::string& path) const; 177 /**检查路径是否是一个目录。 178 * Checks whether the path is a directory. 179 * @param dirPath The path of the directory, it could be a relative or an absolute path. 180 * @return True if the directory exists, false if not. 181 */ 182 virtual bool isDirectoryExist(const std::string& dirPath) const; 183 /** 创建一个字典目录 184 * Creates a directory. 185 * @param dirPath The path of the directory, it must be an absolute path. 186 * @return True if the directory have been created successfully, false if not. 187 */ 188 virtual bool createDirectory(const std::string& dirPath); 189 /** 移除一个目录 190 * Removes a directory. 191 * @param dirPath The full path of the directory, it must be an absolute path. 192 * @return True if the directory have been removed successfully, false if not. 193 */ 194 virtual bool removeDirectory(const std::string& dirPath); 195 /** 移除一个文件 196 * Removes a file. 197 * @param filepath The full path of the file, it must be an absolute path. 198 * @return True if the file have been removed successfully, false if not. 199 */ 200 virtual bool removeFile(const std::string &filepath); 201 /** 给指定目录下的文件重命名 202 * Renames a file under the given directory. 203 * @param path The parent directory path of the file, it must be an absolute path. 204 * @param oldname The current name of the file. 205 * @param name The new name of the file. 206 * @return True if the file have been renamed successfully, false if not. 207 */ 208 virtual bool renameFile(const std::string &path, const std::string &oldname, const std::string &name); 209 /** 给指定目录下的文件重命名 210 * Renames a file under the given directory. 211 * @param oldfullpath The current fullpath of the file. Includes path and name. 212 * @param newfullpath The new fullpath of the file. Includes path and name. 213 * @return True if the file have been renamed successfully, false if not. 214 */ 215 216 virtual bool renameFile(const std::string &oldfullpath, const std::string &newfullpath); 217 /** 检索文件的大小 218 * Retrieve the file size. 219 * @note If a relative path was passed in, it will be inserted a default root path at the beginning. 220 * @param filepath The path of the file, it could be a relative or absolute path. 221 * @return The file size. 222 */ 223 virtual long getFileSize(const std::string &filepath); 224 /** 返回的完整路径缓存。 225 * Returns the full path cache. 226 */ 227 const std::unordered_map<std::string, std::string>& getFullPathCache() const { return _fullPathCache; } 228 229 protected CONUT: 230 231 /** 在字典中使用一个文件的密钥来查找文件名 232 * Dictionary used to lookup filenames based on a key. 233 * It is used internally by the following methods:基于下面的方法在内部使用 234 * std::string fullPathForFilename(const char*); 235 */ 236 ValueMap _filenameLookupDict; 237 /** 该Vector容器包含有分辨率文件夹。元素在此向量的低指数,该决议目录优先级越高。 238 * The vector contains resolution folders. 239 * The lower index of the element in this vector, the higher priority for this resolution directory. 240 */ 241 std::vector<std::string> _searchResolutionsOrderArray; 242 /**Vector容器包含的搜索路径。 243 * The vector contains search paths. 244 * The lower index of the element in this vector, the higher priority for this search path. 245 */ 246 std::vector<std::string> _searchPathArray; 247 /** 资源的默认根路径。 248 * The default root path of resources. 249 * If the default root path of resources needs to be changed, do it in the `init` method of FileUtils's subclass. 250 * For instance: 251 * On Android, the default root path of resources will be assigned with "assets/" in FileUtilsAndroid::init(). 252 * Similarly on Blackberry, we assign "app/native/Resources/" to this variable in FileUtilsBlackberry::init(). 253 */ 254 std::string _defaultResRootPath; 255 /** 完整路径缓存。当一个文件被发现,它将被添加到该高速缓存。 256 * The full path cache. When a file is found, it will be added into this cache. 257 * This variable is used for improving the performance of file search. 258 */ 259 mutable std::unordered_map<std::string, std::string> _fullPathCache; 260 /**可写路径。 261 * Writable path. 262 */ 263 std::string _writablePath; 264 /** 文件实用的单指针。 265 * The singleton pointer of FileUtils. 266 */ 267 static FileUtils* s_sharedFileUtils;
实例:
.h files
#ifndef _FILEUTILSTEST_SCENE_H_
#define _FILEUTILSTEST_SCENE_H_
#include "cocos2d.h"
class fileUtil : public cocos2d::Layer
{
private:
public:
static cocos2d::Scene* createScene();
virtual bool init();
void fileUtil::testResolutionDirectories(Ref* sender);
void fileUtil::testSearchPath(Ref* sender);
void fileUtil::testFilenameLookup(Ref* sender);
void fileUtil::testIsFileExist(Ref* sender);
void fileUtil::testWritePlist(Ref* sender);
CREATE_FUNC(fileUtil);
};
#endif // _FILEUTILSTEST_SCENE_H_
.cpp files
#include "fileUtilsTest.h"
USING_NS_CC;
Scene* fileUtil::createScene()
{
auto scene = Scene::create();
auto layer = fileUtil::create();
scene->addChild(layer);
return scene;
}
bool fileUtil::init()
{
if (!Layer::init())
{
return false;
}
Size visibleSize = Director::getInstance()->getVisibleSize();
Vec2 origin = Director::getInstance()->getVisibleOrigin();
auto item1 = MenuItemFont::create("testResolutionDirectories", CC_CALLBACK_1(fileUtil::testResolutionDirectories, this));
auto item2 = MenuItemFont::create("testSearchPath", CC_CALLBACK_1(fileUtil::testSearchPath, this));
auto item3 = MenuItemFont::create("testFilenameLookup", CC_CALLBACK_1(fileUtil::testFilenameLookup, this));
auto item4 = MenuItemFont::create("testIsFileExist", CC_CALLBACK_1(fileUtil::testIsFileExist, this));
auto item5 = MenuItemFont::create("testWritePlist", CC_CALLBACK_1(fileUtil::testWritePlist, this));
auto menu = Menu::create(item1, item2, item3, item4, item5, NULL);
menu->setPosition(Vec2(250, visibleSize.height - 200));
menu->alignItemsVerticallyWithPadding(20);
this->addChild(menu);
return true;
}
//设置和获得分辨率的路径;获取某个文件的路径
void fileUtil::testResolutionDirectories(Ref* sender)
{
//不同的平台的不同的设备它们的分辨率也存在着某些差异
//实例化
auto fileUtil = FileUtils::getInstance();
//清除缓存,清空所有的缓存
fileUtil->purgeCachedEntries();
//默认搜索路径,第一次的默认搜索路径是Resource那个文件夹
std::vector<std::string> _defaultSearchPathArray;
_defaultSearchPathArray = fileUtil->getSearchPaths();
std::vector<std::string> searchPath = _defaultSearchPathArray;
//在默认的搜索路径下在添加一个我们自己的搜索路径
searchPath.insert(searchPath.begin(), "Misc");
//设置新的搜索路径为"Misc"
fileUtil->setSearchPaths(searchPath);
//获得搜索分辨率资源路径
std::vector<std::string> _defaultResolutionsOrderArray = fileUtil->getSearchResolutionsOrder();
std::vector<std::string> resolutionsOrder = _defaultResolutionsOrderArray;
//添加分辨率资源路径
//在依次的在下面的文件名路径下依次的查找所要查找的内容
resolutionsOrder.insert(resolutionsOrder.begin(), "resources-ipadhd");
resolutionsOrder.insert(resolutionsOrder.begin() + 1, "resources-ipad");
resolutionsOrder.insert(resolutionsOrder.begin() + 2, "resources-widehd");
resolutionsOrder.insert(resolutionsOrder.begin() + 3, "resources-wide");
resolutionsOrder.insert(resolutionsOrder.begin() + 4, "resources-hd");
resolutionsOrder.insert(resolutionsOrder.begin() + 5, "resources-iphone");
//重新设置路径
fileUtil->setSearchResolutionsOrder(resolutionsOrder);
for (int i = 1; i < 7; i++)
{
//创建6个文件名:text~.txt
auto filename = String::createWithFormat("test%d.txt", i);
//fullPathForFilename(filename->getCString())取得当前对象文件的一个绝对路径;如何查找,它会在上面所有设定好的文件名称下,依次的来查找
std::string ret = fileUtil->fullPathForFilename(filename->getCString());
log("%s --> %s", filename->getCString(), ret.c_str());
}
}
//搜索路径
void fileUtil::testSearchPath(Ref* sender)
{
//实例化
auto fileUtil = FileUtils::getInstance();
std::string ret;
//清除缓存,清空所有的缓存
fileUtil->purgeCachedEntries();
std::vector<std::string> _defaultSearchPathArray = fileUtil->getSearchPaths();
std::vector<std::string> searchPaths = _defaultSearchPathArray;
//getWritablePath();获得一个可写的路径
std::string writablePath = fileUtil->getWritablePath();
std::string fileName = writablePath + "external.txt";
char szBuf[100] = "Hello Cocos2d-x!";
FILE* fp = fopen(fileName.c_str(), "wb");
if (fp)
{
size_t ret = fwrite(szBuf, 1, strlen(szBuf), fp);
CCASSERT(ret != 0, "fwrite function returned zero value");
fclose(fp);
if (ret != 0)
log("Writing file to writable path succeed");
}
//下面是设置或者添加几个可写分辨路径
searchPaths.insert(searchPaths.begin(), writablePath);
searchPaths.insert(searchPaths.begin() + 1, "Misc/searchpath1");
searchPaths.insert(searchPaths.begin() + 2, "Misc/searchpath2");
fileUtil->setSearchPaths(searchPaths);
//取得分辨路径
std::vector<std::string> _defaultResolutionsOrderArray = fileUtil->getSearchResolutionsOrder();
std::vector<std::string> resolutionsOrder = _defaultResolutionsOrderArray;
//添加一个路径resources-ipad
resolutionsOrder.insert(resolutionsOrder.begin(), "resources-ipad");
fileUtil->setSearchResolutionsOrder(resolutionsOrder);
for (int i = 1; i<3; i++)
{
auto filename = String::createWithFormat("file%d.txt", i);
ret = fileUtil->fullPathForFilename(filename->getCString());
log("%s --> %s", filename->getCString(), ret.c_str());
}
// Gets external.txt from writable path
std::string fullPath = fileUtil->fullPathForFilename("external.txt");
log("external file path = %s", fullPath.c_str());
if (fullPath.length()>0)
{//rb是一个只读的权限
fp = fopen(fullPath.c_str(), "rb");
if (fp)
{
char szReadBuf[100] = { 0 };
int read = fread(szReadBuf, 1, strlen(szBuf), fp);
if (read>0)
{
log("The content of file from writable path: %s", szReadBuf);
}
fclose(fp);
}
}
}
//文件查找
//测试文件名查找
void fileUtil::testFilenameLookup(Ref* sender)
{
//实例化
auto sharedFileUtils = FileUtils::getInstance();
ValueMap dict;
dict["grossini.bmp"] = Value("Images/grossini.png");
dict["grossini.xcf"] = Value("Images/grossini.png");
//设置一个按文件名查找的字典
sharedFileUtils->setFilenameLookupDictionary(dict);
// Instead of loading carlitos.xcf, it will load grossini.png
auto sprite = Sprite::create("grossini.png");
this->addChild(sprite);
auto s = Director::getInstance()->getWinSize();
sprite->setPosition(Vec2(s.width / 2, s.height / 2));
}
//判断文件是否存在
//测试文件是否存在
void fileUtil::testIsFileExist(Ref* sender)
{
auto s = Director::getInstance()->getWinSize();
auto sharedFileUtils = FileUtils::getInstance();
Label* pTTF = nullptr;
bool isExist = false;
isExist = sharedFileUtils->isFileExist("Images/grossini.png");
pTTF = Label::createWithSystemFont(isExist ? "Images/grossini.png exists" : "Images/grossini.png doesn't exist", "", 20);
pTTF->setPosition(Vec2(s.width / 2, s.height / 3));
this->addChild(pTTF);
}
//写plist配置文件
//测试写plist文件
void fileUtil::testWritePlist(Ref* sender)
{
//创建一个字典
auto root = Dictionary::create();
//设置字典的key-》String element value
auto string = String::create("String element value");
root->setObject(string, "string element key");
//创建一个数组
auto array = Array::create();
//在数组里面添加一个字典
auto dictInArray = Dictionary::create();
//往字典里面添加两个对象
dictInArray->setObject(String::create("string in dictInArray value 0"), "string in dictInArray key 0");
dictInArray->setObject(String::create("string in dictInArray value 1"), "string in dictInArray key 1");
//再将字典添加到数组里面去
array->addObject(dictInArray);
array->addObject(String::create("string in array"));
//在数组中在添加一个数组
auto arrayInArray = Array::create();
arrayInArray->addObject(String::create("string 0 in array"));
arrayInArray->addObject(String::create("string 1 in array"));
array->addObject(arrayInArray);
root->setObject(array,"array");
//在字典中在嵌套字典
auto dictInDict = Dictionary::create();
dictInDict->setObject(String::create("string in dictInDict value"), "String in dictInDict key");
//add booleans to the plist
auto booleanObject = Bool::create(true);
dictInDict->setObject(booleanObject, "bool");
//add integer to the plist
auto intObject = Integer::create(624);
dictInDict->setObject(intObject, "integer");
//add float to the plist
auto floatObject = Float::create(524.2);
dictInDict->setObject(floatObject, "float");
//add double to the plist
auto doubleObject = Double::create(524.2);
dictInDict->setObject(doubleObject, "double");
root->setObject(dictInDict, "dictInDict, hello world!");
//end with
//在拿到一个可写的路径getWritablePath();-——》writablePath
std::string writablePath = FileUtils::getInstance()->getWritablePath();
//在拿到的可写路径下添加一个text.plist文件
std::string fullPath = writablePath + "text.plist";
//调用writeToFile方法进行写操作
if (root->writeToFile(fullPath.c_str()))
log("see the plist file at %s", fullPath.c_str());
else
log("write plist file failed");
auto label = LabelTTF::create(fullPath.c_str(), "Arial", 12);
this->addChild(label);
auto winsize = Director::getInstance()->getWinSize();
label->setPosition(Vec2(winsize.width / 2, winsize.height / 3));
//根据文件的内容来创建一个字典
auto loadDict = __Dictionary::createWithContentsOfFile(fullPath.c_str());
auto loadDictInDict = (__Dictionary*)loadDict->objectForKey("dictInDict,hello world");
auto boolValue = (__String*)loadDictInDict->objectForKey("bool");
CCLOG("%s", boolValue->getCString());
auto floatValue = (__String*)loadDictInDict->objectForKey("float");
CCLOG("%s", floatValue->getCString());
auto doubleValue = (__String*)loadDictInDict->objectForKey("double");
CCLOG("%s", doubleValue->getCString());
auto integerValue = (__String*)loadDictInDict->objectForKey("int");
CCLOG("%s", integerValue->getCString());
}
UserDefault
在上面实现了数据的读写等一些操作,但是游戏的某些数据时要实现持久化的,因此Cocos2d-x引擎中有提供了一个类UserDefault来让我们来实现数据的持久化。UserDefault可以实现数据的存储,但是它不宜储存大量的数据,一般的情况下,用于保存一些游戏设置和玩家偏好设置;数据持久化就是数据能够存储起来,然后在需要的时候可以查找回来,即使设备从新启动也可以查找回来。在UserDefault提供了对int, double, bool和string等数据类型的读写。
UserDefault所支持的数据类型:
在Cocos2d-x中能够多种持久化的方式;
1. 普通文本文件的持久化。
2. UserDefault.可以设置用户的偏好设置等一些少量的数据
3. 属性列表。
4. SQL数据库
API中的常用函数:
1 // get value methods 2 /**根据键值取出布尔值 3 * Get bool value by key, if the key doesn't exist, will return false. 4 * You can set the default value, or it is false. 5 * @param key The key to get value. 6 * @return Bool value by `key`. 7 */ 8 bool getBoolForKey(const char* key); 9 /**根据键值取出布尔值,如果键不存在,返回defaultValue 10 * Get bool value by key, if the key doesn't exist, will return passed default value. 11 * @param key The key to get value. 12 * @param defaultValue The default value to return if the key doesn't exist. 13 */ 14 virtual bool getBoolForKey(const char* key, bool defaultValue); 15 /**根据键值取出int类型的数据 16 * Get integer value by key, if the key doesn't exist, will return 0. 17 * You can set the default value, or it is 0. 18 * @param key The key to get value. 19 * @return Integer value of the key. 20 */ 21 int getIntegerForKey(const char* key); 22 /**根据键值取出int类型的数据,如果键不存在,返回defaultValue 23 * Get bool value by key, if the key doesn't exist, will return passed default value. 24 * @param key The key to get value. 25 * @param defaultValue The default value to return if the key doesn't exist. 26 * @return Integer value of the key. 27 */ 28 virtual int getIntegerForKey(const char* key, int defaultValue); 29 /**根据键值取出float类型的数据 30 * Get float value by key, if the key doesn't exist, will return 0.0. 31 * @param key The key to get value. 32 * @return Float value of the key. 33 */ 34 float getFloatForKey(const char* key); 35 /**根据键值取出float类型的数据,如果键不存在,返回defaultValue 36 * Get float value by key, if the key doesn't exist, will return passed default value. 37 * @param key The key to get value. 38 * @param defaultValue The default value to return if the key doesn't exist. 39 * @return Float value of the key. 40 */ 41 virtual float getFloatForKey(const char* key, float defaultValue); 42 /**根据键值取出double类型的数据 43 * Get double value by key, if the key doesn't exist, will return 0.0. 44 * @param key The key to get value. 45 * @return Double value of the key. 46 */ 47 double getDoubleForKey(const char* key); 48 /**根据键值取出double类型的数据,如果键不存在,返回defaultValue 49 * Get double value by key, if the key doesn't exist, will return passed default value. 50 * @param key The key to get value. 51 * @param defaultValue The default value to return if the key doesn't exist. 52 * @return Double value of the key. 53 */ 54 virtual double getDoubleForKey(const char* key, double defaultValue); 55 /**根据键值取出string类型的数据 56 * Get string value by key, if the key doesn't exist, will return an empty string. 57 * @param key The key to get value. 58 * @return String value of the key. 59 */ 60 std::string getStringForKey(const char* key); 61 /**根据键值取出string类型的数据,如果键不存在,返回defaultValue 62 * Get string value by key, if the key doesn't exist, will return passed default value. 63 * @param key The key to get value. 64 * @param defaultValue The default value to return if the key doesn't exist. 65 * @return String value of the key. 66 */ 67 virtual std::string getStringForKey(const char* key, const std::string & defaultValue); 68 /**根据键值取出Data类型的数据 69 * Get Data value by key, if the key doesn't exist, will return an empty Data. 70 * @param key The key to get value. 71 * @return Data value of the key. 72 */ 73 Data getDataForKey(const char* key); 74 /**根据键值取出Data类型的数据,如果键不存在,返回defaultValue 75 * Get Data value by key, if the key doesn't exist, will return an empty Data. 76 * @param key The key to get value. 77 * @param defaultValue The default value to return if the key doesn't exist. 78 * @return Data value of the key. 79 */ 80 virtual Data getDataForKey(const char* key, const Data& defaultValue); 81 // set value methods 82 /**根据键写入布尔值 83 * Set bool value by key. 84 * @param key The key to set. 85 * @param value A bool value to set to the key. 86 */ 87 virtual void setBoolForKey(const char* key, bool value); 88 /**根据键写入int类型数据 89 * Set integer value by key. 90 * @param key The key to set. 91 * @param value A integer value to set to the key. 92 */ 93 virtual void setIntegerForKey(const char* key, int value); 94 /**根据键写入float类型数据 95 * Set float value by key. 96 * @param key The key to set. 97 * @param value A float value to set to the key. 98 */ 99 virtual void setFloatForKey(const char* key, float value); 100 /**根据键写入double类型数据 101 * Set double value by key. 102 * @param key The key to set. 103 * @param value A double value to set to the key. 104 */ 105 virtual void setDoubleForKey(const char* key, double value); 106 /**根据键写入String类型数据 107 * Set string value by key. 108 * @param key The key to set. 109 * @param value A string value to set to the key. 110 */ 111 virtual void setStringForKey(const char* key, const std::string & value); 112 /**根据键写入Data类型数据 113 * Set Data value by key. 114 * @param key The key to set. 115 * @param value A Data value to set to the key. 116 */ 117 virtual void setDataForKey(const char* key, const Data& value); 118 /**调用此函数会将我们所改变的数据保存在.xml文件中去。 119 * You should invoke this function to save values set by setXXXForKey(). 120 */ 121 virtual void flush(); 122 /** 123 * delete any value by key, 124 * @param key The key to delete value. 125 */ 126 virtual void deleteValueForKey(const char* key); 127 /** 128 * Returns the singleton. 129 */ 130 static UserDefault* getInstance(); 131 /** 132 * 133 */ 134 static void destroyInstance(); 135 /** 136 * You can inherit from platform dependent implementation of UserDefault, such as UserDefaultAndroid, 137 * and use this function to set delegate, then UserDefault will invoke delegate's implementation. 138 * For example, your store native data base or other format store. 139 * If you don't want to system default implementation after setting delegate, you can just pass nullptr 140 * to this function. 141 * @warm It will delete previous delegate 142 */ 143 static void setDelegate(UserDefault *delegate); 144 /** @deprecated Use getInstace() instead. 145 */ 146 CC_DEPRECATED_ATTRIBUTE static UserDefault* sharedUserDefault(); 147 /**@deprecated Use destroyInstance() instead. 148 */ 149 CC_DEPRECATED_ATTRIBUTE static void purgeSharedUserDefault(); 150 /** All supported platforms other iOS & Android use xml file to save values. This function is return the file path of the xml path. 151 */ 152 static const std::string& getXMLFilePath(); 153 /** All supported platforms other iOS & Android and CC_PLATFORM_WINRT use xml file to save values. This function checks whether the xml file exists or not. 154 * @return True if the xml file exists, false if not. 155 */ 156 static bool isXMLFileExist();
实例:
.h files
#ifndef _USERDEFAULTTEST_SCENE_H_
#define _USERDEFAULTTEST_SCENE_H_
#include "cocos2d.h"
class userDefault : public cocos2d::Layer
{
private:
public:
static cocos2d::Scene* createScene();
virtual bool init();
void testUserDefault(Ref* sendef);
CREATE_FUNC(userDefault);
};
#endif // _USERDEFAULTTEST_SCENE_H_
.cpp files
#include "UserDefaultTest.h"
USING_NS_CC;
Scene* userDefault::createScene()
{
auto scene = Scene::create();
auto layer = userDefault::create();
scene->addChild(layer);
return scene;
}
bool userDefault::init()
{
if (!Layer::init())
{
return false;
}
Size visibleSize = Director::getInstance()->getVisibleSize();
Vec2 origin = Director::getInstance()->getVisibleOrigin();
auto item = MenuItemFont::create("Test", CC_CALLBACK_1(userDefault::testUserDefault, this));
auto menu = Menu::create(item, NULL);
this->addChild(menu);
return true;
}
void userDefault::testUserDefault(Ref* sendef)
{
//set default value
UserDefault::getInstance()->setStringForKey("String", "value1");
UserDefault::getInstance()->setIntegerForKey("Integer", 100);
UserDefault::getInstance()->setFloatForKey("Float", 5.326f);
UserDefault::getInstance()->setDoubleForKey("Double", 3.1415967);
UserDefault::getInstance()->setBoolForKey("Bool", false);
//printf value
std::string ret = UserDefault::getInstance()->getStringForKey("String");
CCLOG("string is %s", ret.c_str());
int intValue = UserDefault::getInstance()->getIntegerForKey("Integer");
CCLOG("Integer value is %d", intValue);
float floValue = UserDefault::getInstance()->getFloatForKey("Float");
CCLOG("Float value is %f", floValue);
double douValue = UserDefault::getInstance()->getDoubleForKey("Double");
CCLOG("Double value is %f", douValue);
bool boolValue = UserDefault::getInstance()->getBoolForKey("Bool");
if (boolValue)
CCLOG("bool value is true");
else
CCLOG("bool value is false");
//CCUserDefault::getInstance()->flush();
CCLOG("改变后的数据:");
UserDefault::getInstance()->setStringForKey("String", "value2");
UserDefault::getInstance()->setIntegerForKey("Integer", 10);
UserDefault::getInstance()->setFloatForKey("Float", 15.326f);
UserDefault::getInstance()->setDoubleForKey("Double", 2 * 3.1415967);
UserDefault::getInstance()->setBoolForKey("Bool", true);
UserDefault::getInstance()->flush();
//after change value
ret = UserDefault::getInstance()->getStringForKey("String");
CCLOG("string is %s", ret.c_str());
intValue = UserDefault::getInstance()->getIntegerForKey("Integer");
CCLOG("Integer value is %d", intValue);
floValue = UserDefault::getInstance()->getFloatForKey("Float");
CCLOG("Float value is %f", floValue);
douValue = UserDefault::getInstance()->getDoubleForKey("Double");
CCLOG("Double value is %f", douValue);
boolValue = UserDefault::getInstance()->getBoolForKey("Bool");
if (boolValue)
CCLOG("bool value is true");
else
CCLOG("bool value is false");
}