Cococs2d-x 之文件操作

字符串操作

cocos 中用到三种字符串，C 字符串char*，C++ 字符串std::string和cocos定义的字符串。
C 字符串是最基本的字符串，C++ 字符串是对 C 字符串的二次封装，cocos 字符串是对 C 和 C++ 字符串的再次封装，它继承 Ref 和 clonable，在 cocos 中是一个对象，并引入计数引用技术。

    //c字符串与c++字符串
    char* cstr = "helloworld";
    log("str len: %d",strlen(cstr));
    log("c str: %s",cstr);
    //c字符串转c++字符串
    std::string* ccstr= new std::string(cstr);
    //c++字符串转c字符串
    log("c++ str: %s",ccstr->c_str());

    //c字符串与cocos字符串
    //c字符串转cocos字符串
    __String* cocstr = __String::createWithFormat("%s", cstr);
    //cocos字符串转c字符串
    log("cocos str: %s",cocstr->getCString());

    //c++字符串与cocos字符串
    //c++字符串转cocos字符串
    cocstr = __String::create(*ccstr);
    log("cocos str: %s", cocstr->getCString());

    //字符串操作
    std::string str=StringUtils::format("%3d %3.2f %c %s", 12, 3.1425926, 'a', "linjinxin");
    log(str.c_str());

文件读写操作

    //目录操作
    //获得系统可写路径
    log("%s", FileUtils::getInstance()->getWritablePath());
    //获取文件完整路径
    log("%s", FileUtils::getInstance()->fullPathForFilename("data.txt").c_str());
    //获取文件相对于特定文件夹的完整路径
    log("%s", FileUtils::getInstance()->fullPathFromRelativeFile("data.txt", FileUtils::getInstance()->getWritablePath()).c_str());

    //读文件
    Data data = FileUtils::getInstance()->getDataFromFile(FileUtils::getInstance()->fullPathForFilename("data.txt").c_str());
    log("%s", data.getBytes());
    data = FileUtils::getInstance()->getDataFromFile(FileUtils::getInstance()->fullPathFromRelativeFile("data.txt",FileUtils::getInstance()->getWritablePath()).c_str());
    log("%s", data.getBytes());

    //写文件
    //FILE* f = fopen(FileUtils::getInstance()->fullPathForFilename("data.txt").c_str(), "w+");
    FILE* f = fopen("data.txt", "w");
    fprintf(f, "hello cocos2d-x in local resources!");
    fclose(f);
    f = fopen(FileUtils::getInstance()->fullPathFromRelativeFile("data.txt", FileUtils::getInstance()->getWritablePath()).c_str(), "w");
    fprintf(f, "hello cocos2d-x in system path!");
    fclose(f);

各种文件操作

首选项数据

每个cocos项目会在系统可写目录下创建一个UserDefault.xml文件，用于保存少量的游戏数据，程序员无需操作文件，只需调用简单的API即可对这些数据进行读写。

    //首选项数据
    str = UserDefault::getInstance()->getStringForKey("name", "no find");
    log("name:%s", str.c_str());
    UserDefault::getInstance()->setStringForKey("name", "linjinxin");
    UserDefault::getInstance()->setIntegerForKey("age", 21);
    str = UserDefault::getInstance()->getStringForKey("name", "no find");
    auto age = UserDefault::getInstance()->getIntegerForKey("age", 18);
    log("name:%s,age:%d", str.c_str(), age);

配置文件

cocos中有一个全局的Configuration，包含一些 openGL 变量的Configuration。我们也可以用这个文件来读写一些配置。

    //配置文件
    Configuration* config = Configuration::getInstance();
    config->loadConfigFile("config.plist");
    log("name:%s", config->getValue("name").asString().c_str());
    log("gate:%d", config->getValue("gate", Value(0)));
    config->setValue("gate", Value(5));
    log("gate:%d", config->getValue("gate", Value(0)));

Plist文件读写

Plist 文件全称 Property List，即属性列表，是 ios 采用的配置文件格式，cocos2d-x 发展自 cocos，而 cocos 最早是运行在 ios 上的，所以cocos2d-x 仍支持 plist 文件的操作。plist 文件的本质是是xml，再结合的 json 的特点，根结点有数组和字典两种方式。使用Plist文件可解决cocos2d中的中文乱码问题。
根结点为字典的格式：

<?xml version="1.0" encoding="utf-8"?>
<plist version="1.0">
    <dict>
        <key>name</key>
    <string>林锦新</string>
    <key>age</key>
    <string>18</string>
    </dict>
</plist>

读取代码：

ValueMap vm = FileUtils::getInstance()->getValueMapFromFile("dict.plist");
log("%s %d", vm["name"].asString().c_str(),vm["age"].asInt());

根结点为数组的格式：

<?xml version="1.0" encoding="utf-8"?>
<plist version="1.0">
    <array>
    <string>林锦新</string> 
    <string>18</string>
    </array>
</plist>

读取代码：

ValueVector vv=FileUtils::getInstance()->getValueVectorFromFile("arr.plist");
log("%s %d", vv[0].asString().c_str(),vv[1].asInt());

xml文件读写

xml是一种应用十分广泛的数据存储格式，像上面的PList文件，其本质也是xml文件。每个xml文件有且只有一个根结点，有多个根结点只识别第一个结点作为根结点，其它结点被忽略。xml文件由层级关系的父子结点及结点属性组成。

<?xml version="1.0" encoding="utf-8"?>
<data>
  <p name="zhangshan" age="18">
    <address province="广东省" city="广州市"/>
  </p>
  <p name="lishi" age="20"/>
</data>

cocos2d要解析和创建xml文件必须先引入一个库

#include "tinyxml2/tinyxml2.h"

下面解析xml文件，采用递归的方式从根结点开始遍历所有的子结点。

//xml文件解析
tinyxml2::XMLDocument xmlDoc;
xmlDoc.Parse(FileUtils::getInstance()->getStringFromFile("data.xml").c_str());
//获得根结点
tinyxml2::XMLElement *root = xmlDoc.RootElement();
//xml解析
xmlParse(root);

//xml解析
void HelloFile::xmlParse(tinyxml2::XMLElement* root) {
    //遍历当前结点的子结点
    for (tinyxml2::XMLElement* e = root->FirstChildElement(); e; e = e->NextSiblingElement()) {
        std::string str;
        //获得结点名称
        str = StringUtils::format("%s=", e->Name());
        //遍历当前结点的属性
        for (const tinyxml2::XMLAttribute* attr = e->FirstAttribute(); attr; attr = attr->Next()) {
            str = str + "(" + attr->Name() + "=" + attr->Value() + ");";
        }
        log("%s", str.c_str());
        //递归遍历子结点
        xmlParse(e);
    }
}

下面再看一下xml文件的创建

//创建xml文件
void HelloFile::xmlCreate() {
    //声明xml文档
    tinyxml2::XMLDocument* doc = new tinyxml2::XMLDocument();
    //声明xml文件头
    tinyxml2::XMLDeclaration* pDec = doc->NewDeclaration("xml version=\"1.0\" encoding=\"utf-8\"");
    //将文件头链接到文件
    doc->LinkEndChild(pDec);
    //声明根结点
    tinyxml2::XMLElement* root = doc->NewElement("root");
    //为根结点添加属性
    root->SetAttribute("type", "game");
    root->SetAttribute("version", 5);
    //声明子结点并添加到根结点
    tinyxml2::XMLElement* first = doc->NewElement("p");
    first->SetAttribute("name", "zhangshan");
    tinyxml2::XMLElement* second = doc->NewElement("q");
    second->SetAttribute("name", "lishi");
    root->InsertFirstChild(first);
    root->InsertAfterChild(first, second);
    tinyxml2::XMLElement* grandson = doc->NewElement("address");
    grandson->SetAttribute("city", "guangzhou");
    first->InsertFirstChild(grandson);
    //将根结点添加到文档
    doc->InsertEndChild(root);
    //保存文档
    //文件会保存在Resource目录下
    doc->SaveFile("newData.xml");
    //释放内存
    delete doc;
}

保存后的文件内容：

<?xml version="1.0" encoding="utf-8"?>
<root type="game" version="5">
    <p name="zhangshan">
        <address city="guangzhou"/>
    </p>
    <q name="lishi"/>
</root>

使用xml文件也可以解决 cocos2d 中的中文乱码问题。

json文件读写

json文件有两种存储方式，一种是根结点是数组，一种是根结点为对象（集合）。
cocos中读写json文件要先引入下列库：

#include "json/rapidjson.h"
#include "json/document.h"
#include "json/stringbuffer.h"
#include "json/writer.h"

创建json文件（数组格式）

//以数组格式创建json
void HelloFile::jsonCreateWithArray() {
    //声明json文档
    rapidjson::Document doc;
    //设置json文档格式为数组
    doc.SetArray();
    //声明Allocator
    rapidjson::Document::AllocatorType& allocator = doc.GetAllocator();

    //声明json对象
    rapidjson::Value obj1(rapidjson::kObjectType);
    rapidjson::Value obj2(rapidjson::kObjectType);
    //声明json数组
    rapidjson::Value arr1(rapidjson::kArrayType);

    //为对象赋值
    obj1.AddMember("name", "zhangshan",allocator);
    obj1.AddMember("age", 18, allocator);
    obj2.AddMember("name", "Lishi",allocator);
    //为数组添加元素
    arr1.PushBack("hero", allocator);
    arr1.PushBack("moster", allocator);
    arr1.PushBack("judge", allocator);

    //将所有对象和数组添加到根数组
    doc.PushBack(obj1, allocator);
    doc.PushBack(obj2, allocator);
    doc.PushBack(arr1, allocator);

    //声明字符缓冲
    rapidjson::StringBuffer buffer;
    //声明写入器
    rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
    //写入json文档
    doc.Accept(writer);

    //保存到文件
    FILE* f = fopen("newArray.json", "w");
    fprintf(f, StringUtils::format("%s", buffer.GetString()).c_str());
    fclose(f);
}

文件内容：

<pre name="code" class="html">[
  {
    "name": "zhangshan",
    "age": 18
  },
  { "name": "Lishi" },
  [ "hero", "moster", "judge" ]
]

创建json文件（对象格式）

//以对象格式创建json
void HelloFile::jsonCreateWithObject() {
    //声明json文档
    rapidjson::Document doc;
    //设置根结点为对象
    doc.SetObject();
    //声明Allocator
    rapidjson::Document::AllocatorType& allocator = doc.GetAllocator();

    //声明json对象
    rapidjson::Value obj1(rapidjson::kObjectType);
    rapidjson::Value obj2(rapidjson::kObjectType);
    //声明json数组
    rapidjson::Value arr1(rapidjson::kArrayType);

    //为对象赋值
    obj1.AddMember("name", "zhangshan", allocator);
    obj1.AddMember("age", 18, allocator);
    obj2.AddMember("name", "Lishi", allocator);
    //为数组添加元素
    arr1.PushBack("hero", allocator);
    arr1.PushBack("moster", allocator);
    arr1.PushBack("judge", allocator);

    //将所有对象和数组添加到根数组
    doc.AddMember("character1", obj1, allocator);
    doc.AddMember("character2", obj2, allocator);
    doc.AddMember("statement", arr1, allocator);

    //声明字符缓冲
    rapidjson::StringBuffer buffer;
    //声明写入器
    rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
    //写入json文档
    doc.Accept(writer);

    //保存到文件
    FILE* f = fopen("newObject.json", "w");
    fprintf(f, StringUtils::format("%s", buffer.GetString()).c_str());
    fclose(f);
}

文件内容：

{
  "character1": {
    "name": "zhangshan",
    "age": 18
  },
  "character2": { "name": "Lishi" },
  "statement": [ "hero", "moster", "judge" ]
}

解析数组格式，我们解析上面创建的文件：

//解析数组格式的json文件
void HelloFile::jsonParseWithArray() {
    rapidjson::Document doc;
    doc.Parse(FileUtils::getInstance()->getStringFromFile("newArray.json").c_str());
    log("%s", doc[(int)0]["name"].GetString());
    log("%d", doc[(int)0]["age"].GetInt());
    log("%s", doc[2][0].GetString());
}

解析 对象格式，我们解析上面创建的文件：

//解析对象格式的json文件
void HelloFile::jsonParseWithObject() {
    rapidjson::Document doc;
    doc.Parse(FileUtils::getInstance()->getStringFromFile("newObject.json").c_str());
    log("%s", doc["character1"]["name"].GetString());
    log("%d", doc["character1"]["age"].GetInt());
    log("%s", doc["statement"][0].GetString());
}