Skip to content

document_zh

Jump to bottom
YANG Huan edited this page May 19, 2021 · 41 revisions

详细导出规则说明

1.标记Sheet页为可导出


标识符需满足C语言的命名规则，后面提及的标识符均按此要求。

2.表头格式

格式1(常用格式，每一行可认为是一个对象)


前4行为表头，描述了导出的格式与信息，下面逐行解释。

  • 第一行是描述信息
  • 第二行是字段的类型信息，有基本类型（int,string,double,bool）、数组以及结构体，后面会详细描述
  • 第三行是字段名，需满足标识符定义
  • 第四行是导出标记，配合命令行参数“-s”使用,可控制此列是否被导出
  • 从第5行开始，是数据部分

格式2（配置参数格式）


列数量固定为5，分别是字段名，字段值，字段类型，导出标记，描述信息，表头仅一行，其余为数据部分。
此种格式一般用来配置一些全局参数或者多语言文本信息等

3.字段类型

包含基本类型（int,string,double,bool）、数组以及结构体，参考C语言语法设计，简洁易懂，下面逐个介绍

  • int 整形
  • string 字符串类型
  • double 小数类型
  • bool 布尔类型，填写数值的话，0为假,其余为真,填写字符串的话，false、no、off为假，true，yes，on为真（大小写不敏感）
  • [] 数组类型，可与基本类型以及结构体嵌套。例如类型为“int[]”, 值可为“[1,2,3,4,5]”,首尾的“[]”可不填写，简易写法为“1,2,3,4,5”
  • {} 结构体类型，可与数组嵌套。例如“{string Name:int Age}”,值可为“{张三:23}”，首尾的“{}”可不填写,简易写法为“张三:23”

,:分别作为数组和结构体的分隔符,若与字符串产生冲突,则字符串中的,:需要转义成 \, \:

4.注释(使部分数据不导出)

  • 行注释，此行第一列的单元格为空或者第一个字符为“#”，表明注释掉此行，此行数据不导出
  • 列注释，此列的字段名，字段类型中有一个不填写，此列不完整，此列不会导出
  • 段落注释，从某一行开始，连续3行均为空白行，后续行跳过，均不会导出

5.合并多个Sheet页


此配置将会把后面的配置项合并至第一个配置项并导出。

实例工程

https://github.com/yanghuan/proton#实例工程

交流讨论

Please Enjoy

Clone this wiki locally