Cocos2d-x数据模块教程05：CSV文件解析

   通常在一个游戏中会有很多怪物、关卡、技能等数据信息，这些数据不可能在代码里写死，一般都会使用配置文件保存，使用时再加载到内存。

       CSV文件编辑起来十分简单，所以常常用来配置游戏的数据信息。本篇要介绍的就是：如何读取CSV文件格式的数据。

 

【CSVParser解析器下载】

下载地址：https://github.com/shahdza/Cocos_LearningTest/tree/master/CSVParser

 

【CSV简介】

1、什么是CSV？

CSV，即逗号分隔值（Comma-Separated Values）。有时也称为字符分隔值，因为分隔字符也可以不是逗号，可以是分号;），其文件以纯文本形式存储表格数据（数字和文本）。

这种文件格式经常用来作为不同程序之间的数据交互的格式。

CSV格式数据的结构类似表格，不同的记录占用一行，一行中的字段用“，”（逗号）分隔。

例如：

 

2、编辑CSV文件

在Mac OS系统上，可以使用 Numbers 来创建表格文件，然后再保存为csv格式的文件即可。

在Windows系统上，可以使用 Excel 来编辑csv文件。

当然你也可以使用其他csv编辑软件。

 

（1）使用Numbers软件，可以很方便的编辑表格数据。

（2）保存为csv格式文件。

（3）打开导出的csv文件，可以发现每条数据占一行，并且每一行的数据用逗号分割。

 

3、CSV格式规则

（1）开头是不留空  ，以行为单位。

（2）每条记录占一行，以逗号为分隔符。列为空也要表达其存在。

（3）可含或不含列名，如果含列名则居文件第一行。

（4）一行数据不跨行，无空行。

（5）字段中包含有逗号符，该字段必须用双引号括起来。

（6）字段中包含有换行符，该字段必须用双引号括起来。

（7）字段前后包含有空格，该字段必须用双引号括起来。（ a b c ==> "a b c"）

（8）字段中的双引号，用两个双引号表示。（ 我说："abc"。 ==> 我说：""abc""。 ）

（9）字段中如果有双引号，该字段必须用双引号括起来。（ 我说："abc"。 ==> "我说：""abc""。" ）

PS：中文的逗号、双引号不需要用双引号包起来。

 

可以看看如下的例子：

 

4、为什么使用CSV？

（1）CSV文件格式占用空间比较小，是文本文件。

（2）CSV文件可以用记事本打开，编辑修改方便。同时也可以用Excel打开。

（3）游戏项目中，策划通常喜欢用 Excel 做数值和配置。 Excel可以直接另存为CSV文件。

（4）配置也可以用xml。Excel同样可以导出xml文件格式。xml不错，但C++的标准库没有xml的读取方法。通常C++项目读xml需要依赖第三方库。例如：TinyXml之类的。

 

【CSV解析】

这里介绍一下C++版本的CSV解析。

注意：CSV文件的编码格式，如在手游中一般使用 UTF-8 编码格式。

PS：笨木头写过Lua版读取CSV数据。参见《Cocos2d-x Lua 读取Csv文件，更方便的使用数据》

 

以下CSV解析的代码，是在这篇的基础上，进行的修改。

使用C/C++标准库编写的，不依赖Cocos2d-x里面的任何一个类或函数。

这样的好处是，增强了CSV解析的通用性，即使在编写控制台应用程序，也可以正常使用。

 

1、CSVParser.h

（1）命名空间：CSVParser

（2）Row类：一行的数据记录。已重载 [] 运算符，可以通过“键值对”方式获取数据值。

（3）Csv类：解析csv文件。已重载 [] 运算符，可以像数组一样获取数据值。

//
#pragma once
#include 
#include 
using namespace  std;
namespace CSVParser {
// 每一行的记录
class Row
{
    public:
        Row() { }
        ~Row() { }
        void push_back(const string& value) { m_values.push_back(value); }
        void setHeader(const vector* header) { m_header = header; }
    public:
        // 每行数据有多少字段
        unsigned int size() const { return m_values.size(); }
        // 运算符 [] 重载
        string& operator[](unsigned int key)
        {
            if (key