libla / SDDL

A structured data definition language, focus on performance and version compatibility.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SDDL (Structured Data Definition Language)

SDDL是一个结构化数据定义语言,可根据定义生成各种语言的数据结构和声明。

关注点:简单、快速、便于扩展和向下兼容。

语法

  • 注释

    以#开始,直到行尾
  • 引用

    最多一个引用块,必须在定义文件最顶部,以当前文件所在目录作为根目录引用其他文件(先编译引用的文件,再编译当前文件)

require {

"FILENAME"

...

}

  • 常量

    定义基本类型(整数/浮点数/字符串/布尔值)的常量符号,一处定义,多处使用,以便于修改

    局部符号(只在该文件有效,最终会直接代入值用于计算其他值,符号名字在编译后不存在,类似C/C++的宏)

local 符号名字 = 任意常量表达式(自动根据表达式类型设置符号类型)

全局符号(被其他文件引用时,在引用文件中也有效,编译后符号名仍存在)

auto 符号名字 = 任意常量表达式(自动根据表达式类型设置符号类型)

integer 符号名字 = 整数常量表达式

number 符号名字 = 浮点数常量表达式

string 符号名字 = 字符串常量表达式

boolean 符号名字 = 布尔常量表达式

整数/浮点数常量表达式支持四则运算(+ - * /)、取余(%)、乘方(^),字符串常量表达式支持连接(..)运算,布尔常量表达式支持条件且(&)、或(|)、取反(!)和整数/浮点数/字符串的比较(== != < > <= >=)判断

  • 消息

    通过基础类型定义扩展类型(亦即协议消息的载体类型),基础类型有整数(integer)/浮点数(number)/字符串(string)/布尔值(boolean)。

类型名字 {

字段类型 字段名字@字段索引 [= 默认值常量/option/array/table/delete]

...

}

同一个扩展类型里面的各字段索引不能相同

字段默认限定为必须,必须字段可以定义一个默认值,在解析协议时若没有打包该字段,则该字段取默认值

若添加option则限定为可选字段,默认值为空(无法自定义)

若添加array则限定为数组字段,默认值为空(无法自定义),可以存多个同类型的值到该字段

若添加table则限定为映射字段,默认值为空(无法自定义),可以以int为键,存多个同类型的值到该字段

若添加delete则该字段被标记为废弃,不会解析和打包该字段,也无法访问,但占用字段索引(字段索引不可重用,以便向下兼容)

  • 消息分发

    通过基础类型和扩展类型定义消息分发的参数。

消息分发组名字 [

消息分发名字@索引 = delete/null/参数类型

...

]

同一个消息分发组里面的名字和索引不能相同

若添加delete则该消息分发被标记为废弃,不会出现在生成代码中,但占用索引(索引不可重用,以便向下兼容)

若添加null则该消息分发无参数

  • 远程调用

    通过基础类型和扩展类型定义远程调用的参数和返回值。

远程调用组名字 (

远程调用名字@索引 = delete/[参数类型][ -> 返回值类型]

...

)

同一个远程调用组里面的名字和索引不能相同

若添加delete则该远程调用被标记为废弃,不会出现在生成代码中,但占用索引(索引不可重用,以便向下兼容)

参数类型和返回值类型都可以省略,此时该远程调用的没有参数和返回值

About

A structured data definition language, focus on performance and version compatibility.

License:MIT License


Languages

Language:C# 96.4%Language:ANTLR 3.6%