热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

Cocos数据篇[3.4](5)——CSV文件解析

【唠叨】在一个游戏中,通常会有很多怪物、关卡、技能等数据,这些数据不可能在代码里写死,一般都会使用配置文件保存,使用时再加载到内存。CSV文件编辑起来十分简单,所以常常用来配置游戏

【唠叨】

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

    CSV文件编辑起来十分简单,所以常常用来配置游戏的数据信息。

    本文要介绍的是:如何读取CSV文件格式的数据。


【扩展阅读】

    http://baike.baidu.com/subview/468993/5926031.htm (CSV百度百科)

    http://blog.csdn.net/stevenkylelee/article/details/38309147 (CSV文件格式解析器的实现)

    http://www.benmutou.com/archives/1634 (Lua 读取Csv文件)




【CSV简介】

    这位大牛的博文写得很好:

        http://blog.csdn.net/stevenkylelee/article/details/38309147 


1、什么是CSV?

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

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

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

    例如:

技术分享


2、编辑CSV文件

    在MacOS系统上   ,可以使用 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数据。参见:http://www.benmutou.com/archives/1634 

    

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

        > 参考代码: http://blog.csdn.net/stevenkylelee/article/details/38309147 

    使用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 < size()) return m_values[key];
            throw "can‘t return this value (doesn‘t exist)";
        }
        
        // 运算符 [] 重载
        string& operator[](const string& key)
        {
            vector::const_iterator it;
            int pos = 0;
            for (it = (*m_header).begin(); it != (*m_header).end(); it++) {
                if (key == *it) return m_values[pos];
                pos++;
            }
            throw "can‘t return this value (doesn‘t exist)";
        }

    private:
        const vector* m_header;
        vector m_values;
    };


    class Csv
    { 
    public:
        Csv(const string& filename);
        ~Csv();
        
        // 解析csv文件
        void Parse(const string& filename);
        
        // 错误信息
        const string& getErrorInfo() const { return m_strErrorInfo; }
        
        // 获取列头字段
        vector getHeader() const { return m_header; }
        // 获取总行数
        unsigned int getRowCount() const { return m_content.size(); }
        // 获取总列数
        unsigned int getColumnCount() const { return m_header.size(); }
        // 运算符 [] 重载
        Row& operator[](unsigned int key);

    private:
        // 读取整个文件的数据
        void Load(const string& filename, string& Data);
        // 设置列头字段,用于[]运算符,以键值对方式获取数据值
        void setHeader();

    private :
        // 原始表格数据
        vector m_content;   // 所有行的数据(包含列头)
        vector m_header; // 列头字段
        // 错误信息
        string m_strErrorInfo;
    };


}
//


2、CSVParser.cpp

    类的实现代码如下:

//
#include "CSVParser.h"


namespace CSVParser {

    Csv::Csv(const string& filename)
    {
        Parse(filename);
    }

    Csv::~Csv()
    {

    }


    void Csv::Load(const string& filename, string& Data)
    {
        // 读取文件数据
        FILE* pFile = fopen(filename.c_str(), "rb");
        if (!pFile) {
            return;
        }
        
        fseek(pFile, 0, SEEK_END);
        long len = ftell(pFile);
        
        char* pBuffer = new char[len + 1];
        
        fseek(pFile, 0, SEEK_SET);
        fread(pBuffer, 1, len, pFile);
        fclose(pFile);
        
        pBuffer[len] = 0;
        Data.assign(pBuffer, len);
        
        delete[] pBuffer;
    }


    void Csv::Parse(const string& filename)
    {
        // 清除之前的数据
        m_content.clear();
        m_strErrorInfo.clear();
        
        string text;
        Load(filename, text);
        
        if (text.size() == 0) {
            return;
        }
        
        // 定义状态
        enum StateType {
            NewFieldStart,      // 新字段开始
            NonQuotesField,     // 非引号字段
            QuotesField,        // 引号字段
            FieldSeparator,     // 字段分隔
            QuoteInQuotesField, // 引号字段中的引号
            RowSeparator,       // 行分隔符字符1,回车
            Error,              // 语法错误
        };
        
        Row Fields = Row();
        string strField;
        
        // 设置初始状态
        StateType State = NewFieldStart;
        
        for (int i = 0, size = text.size(); i < size; ++i) {
            const char& ch = text[i];
            
            switch (State) {
                case NewFieldStart: { // 新字段开始
                    if (ch == ‘"‘) {
                        State = QuotesField;
                    }
                    else if (ch == ‘,‘) {
                        Fields.push_back("");
                        State = FieldSeparator;
                    }
                    else if (ch == ‘\r‘ || ch == ‘\n‘) {
                        m_strErrorInfo = "语法错误:有空行";
                        State = Error;
                    }
                    else {
                        strField.push_back(ch);
                        State = NonQuotesField;
                    }
                }
                break;
                    
                case NonQuotesField: { // 非引号字段
                    if (ch == ‘,‘) {
                        Fields.push_back(strField);
                        strField.clear();
                        State = FieldSeparator;
                    }
                    else if (ch == ‘\r‘) {
                        Fields.push_back(strField);
                        State = RowSeparator;
                    }
                    else {
                        strField.push_back(ch);
                    }
                }
                break;
                    
                case QuotesField: { // 引号字段
                    if (ch == ‘"‘) {
                        State = QuoteInQuotesField;
                    }
                    else {
                        strField.push_back(ch);
                    }
                }
                break;
                    
                case FieldSeparator: { // 字段分隔
                    if (ch == ‘,‘) {
                        Fields.push_back("");
                    }
                    else if (ch == ‘"‘) {
                        strField.clear();
                        State = QuotesField;
                    }
                    else if (ch == ‘\r‘) {
                        Fields.push_back("");
                        State = RowSeparator;
                    }
                    else {
                        strField.push_back(ch);
                        State = NonQuotesField;
                    }
                }
                break;
                    
                case QuoteInQuotesField: { // 引号字段中的引号
                    if (ch == ‘,‘) {
                        // 引号字段闭合
                        Fields.push_back(strField);
                        strField.clear();
                        State = FieldSeparator;
                    }
                    else if (ch == ‘\r‘) {
                        // 引号字段闭合
                        Fields.push_back(strField);
                        State = RowSeparator;
                    }
                    else if (ch == ‘"‘) {
                        // 转义
                        strField.push_back(ch);
                        State = QuotesField;
                    }
                    else {
                        m_strErrorInfo = "语法错误: 转义字符 \" 不能完成转义 或 引号字段结尾引号没有紧贴字段分隔符";
                        State = Error;
                    }
                }
                break;
                    
                case RowSeparator: { // 行分隔符字符1,回车
                    if (ch == ‘\n‘) {
                        m_content.push_back(Fields);
                        Fields = Row(); // Fields.clear();
                        strField.clear();
                        State = NewFieldStart;
                    }
                    else {
                        m_strErrorInfo = "语法错误: 行分隔用了回车 \\r。但未使用回车换行 \\r\\n ";
                        State = Error;
                    }
                }
                break;
                    
                case Error: { // 语法错误
                    return;
                }
                break;

                default: break;
            }
        }
        // end for
        
        switch (State) {
            case NewFieldStart: {
                // Excel导出的CSV每行都以/r/n结尾。包括最后一行
            }
            break;
            
            case NonQuotesField: {
                Fields.push_back(strField);
                m_content.push_back(Fields);
            }
            break;
                
            case QuotesField: {
                m_strErrorInfo = "语法错误: 引号字段未闭合";
            }
            break;
                
            case FieldSeparator: {
                Fields.push_back("");
                m_content.push_back(Fields);
            }
            break;
                
            case QuoteInQuotesField: {
                Fields.push_back(strField);
                m_content.push_back(Fields);
            }
            break;
                
            case RowSeparator: {
                
            }
            break;
                
            case Error: {
                
            }
            break;
                
            default: break;
        }
        
        setHeader();
    }


    void Csv::setHeader()
    {
        m_header.clear();
        for (int i = 0; i < m_content[0].size(); i++) {
            m_header.push_back(m_content[0][i]);
        }
        for (int i = 0; i < m_content.size(); i++) {
            m_content[i].setHeader(&m_header);
        }
    }


    Row& Csv::operator[](unsigned int key)
    {
        if (key < m_content.size()) return m_content[key];
        throw "can‘t return this row (doesn‘t exist)";
    }

}
//


3、使用方法

    (1)csv文件数据

        在MacOS系统上,使用 Numbers 编辑的表格,并导出为csv格式。

技术分享


    (2)解析csv文件,获取数据

//
    #include 
    #include 
    using namespace std;


    //[1] 引入头文件、命名空间
    #include "CSVParser.h"
    using namespace CSVParser;


    int main()
    {
    //[2] csv文件完整路径
        string path = "/soft/cocos2d-x-3.4/projects/Demo34/Resources/testCSV.csv";

    //[3] 解析csv文件
        Csv csv = Csv(path.c_str());

    //[4] 获取总行数(包含列头)、总列数
        printf("总共有 %d 行\n", csv.getRowCount());
        printf("总共有 %d 列\n", csv.getColumnCount());
        
    //[5] 获取所有数据(第0行为列头字段)
        // csv.getRowCount() : 数据总行数(包含列头)
        for (int i =0; i < csv.getRowCount(); i++) {
            // csv[i].size() : 每条数据有多少字段
            for (int j = 0; j < csv[i].size(); j++) {
                printf("%s,", csv[i][j].c_str());
            }
            puts("");
        }
        
    //[6] 也可以根据列头名称,获取数据
        printf("%s\n", csv[2]["备注"].c_str());
        
    //[7] 获取某一行数据
        Row row = csv[4];
        printf("%s\n", row["姓名"].c_str());

        return 0;
    }
//


    (3)运行结果

技术分享



    【源码下载】:http://down.51cto.com/data/1983838 



本文出自 “夏天的风” 博客,请务必保留此出处http://shahdza.blog.51cto.com/2410787/1614802

Cocos数据篇[3.4](5) ——CSV文件解析


推荐阅读
  • 如果应用程序经常播放密集、急促而又短暂的音效(如游戏音效)那么使用MediaPlayer显得有些不太适合了。因为MediaPlayer存在如下缺点:1)延时时间较长,且资源占用率高 ... [详细]
  • malloc 是 C 语言中的一个标准库函数,全称为 memory allocation,即动态内存分配。它用于在程序运行时申请一块指定大小的连续内存区域,并返回该区域的起始地址。当无法预先确定内存的具体位置时,可以通过 malloc 动态分配内存。 ... [详细]
  • 网络爬虫的规范与限制
    本文探讨了网络爬虫引发的问题及其解决方案,重点介绍了Robots协议的作用和使用方法,旨在为网络爬虫的合理使用提供指导。 ... [详细]
  • 微软推出Windows Terminal Preview v0.10
    微软近期发布了Windows Terminal Preview v0.10,用户可以在微软商店或GitHub上获取这一更新。该版本在2月份发布的v0.9基础上,新增了鼠标输入和复制Pane等功能。 ... [详细]
  • 本文介绍了Java编程语言的基础知识,包括其历史背景、主要特性以及如何安装和配置JDK。此外,还详细讲解了如何编写和运行第一个Java程序,并简要介绍了Eclipse集成开发环境的安装和使用。 ... [详细]
  • 本文详细介绍了Linux系统中用于管理IPC(Inter-Process Communication)资源的两个重要命令:ipcs和ipcrm。通过这些命令,用户可以查看和删除系统中的消息队列、共享内存和信号量。 ... [详细]
  • NX二次开发:UFUN点收集器UF_UI_select_point_collection详解
    本文介绍了如何在NX中使用UFUN库进行点收集器的二次开发,包括必要的头文件包含、初始化和选择点集合的具体实现。 ... [详细]
  • 本文介绍了如何在 ASP.NET 中设置 Excel 单元格格式为文本,获取多个单元格区域并作为表头,以及进行单元格合并、赋值、格式设置等操作。 ... [详细]
  • LDAP服务器配置与管理
    本文介绍如何通过安装和配置SSSD服务来统一管理用户账户信息,并实现其他系统的登录调用。通过图形化交互界面配置LDAP服务器,确保用户账户信息的集中管理和安全访问。 ... [详细]
  • 本文详细介绍了如何解决DNS服务器配置转发无法解析的问题,包括编辑主配置文件和重启域名服务的具体步骤。 ... [详细]
  • 自定义滚动条美化页面内容
    当页面内容超出显示范围时,为了提升用户体验和页面美观,通常会添加滚动条。如果默认的浏览器滚动条无法满足设计需求,我们可以自定义一个符合要求的滚动条。本文将详细介绍自定义滚动条的实现过程。 ... [详细]
  • Framework7:构建跨平台移动应用的高效框架
    Framework7 是一个开源免费的框架,适用于开发混合移动应用(原生与HTML混合)或iOS&Android风格的Web应用。此外,它还可以作为原型开发工具,帮助开发者快速创建应用原型。 ... [详细]
  • 本文介绍了如何使用 CMD 批处理脚本进行文件操作,包括将指定目录下的 PHP 文件重命名为 HTML 文件,并将这些文件复制到另一个目录。 ... [详细]
  • 解决Bootstrap DataTable Ajax请求重复问题
    在最近的一个项目中,我们使用了JQuery DataTable进行数据展示,虽然使用起来非常方便,但在测试过程中发现了一个问题:当查询条件改变时,有时查询结果的数据不正确。通过FireBug调试发现,点击搜索按钮时,会发送两次Ajax请求,一次是原条件的请求,一次是新条件的请求。 ... [详细]
  • ### 优化后的摘要本学习指南旨在帮助读者全面掌握 Bootstrap 前端框架的核心知识点与实战技巧。内容涵盖基础入门、核心功能和高级应用。第一章通过一个简单的“Hello World”示例,介绍 Bootstrap 的基本用法和快速上手方法。第二章深入探讨 Bootstrap 与 JSP 集成的细节,揭示两者结合的优势和应用场景。第三章则进一步讲解 Bootstrap 的高级特性,如响应式设计和组件定制,为开发者提供全方位的技术支持。 ... [详细]
author-avatar
书友49812911
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有