添加了一些语法示例文件

Author: A4-Tacks

examples/dexp.mdtlbl

@@ -0,0 +1,21 @@
+#*
+ * 这是bang语言中重要的组成部分, `DExp`
+ * 它是一个特殊的表达式, 在其中可以有多个语句, 然后提供一个句柄来当返回值
+ * 这个句柄在未手动指定时, 由获取该表达式的语句结构指定
+ *
+ * 例如我们熟知的op
+ * op a b oper c; 或者 op oper a b c; 或者 op oper a b; 或者 op a oper b; 中
+ * b和c的类型是一个DExp, 它们的句柄分别为`_0`和`_1`
+ * 也就是说, 我们在使用op x (...) + (...); 时,
+ * 其实是隐式的 op x (_0: ...) + (_1: ...),
+ *
+ * 以下是一些常见的默认句柄:
+ * Cmp: _0 cmp _1 或 cmp _0, 此结构常见于 while, if, goto, do_while
+ * Other: cmd _0 _1 _2 _3 _4 _5 _6 _7 _8 _9 _ _ _,
+ *      那些没有被枚举的语句都会是这个结构, 例如print就是print _0
+ *      cmd是一个Var
+ * 
+ * 此处没有列出的可以到源码中`syntax_def.lalrpop`中
+ * 寻找如Value_0 Value_1 Value_x等结构的使用来查看句柄定义
+ *#
+

examples/insert_sort.mdtlbl

@@ -0,0 +1,47 @@
+#*
+ * 这是提供的一个示例程序
+ * 这是一个插入排序算法
+ *#
+
+do { # 按钮弹起时等待按钮被按下
+    wait 0.1;
+} while (sensor _0 switch1 @enabled;);
+
+read length cell1 0; # 被排序的数组长
+set i 1;
+while i < length {
+    read num bank1 i;
+    set j i;
+    while (j: set c j; op j j - 1;) >= 0 {
+        read num_1 bank1 j;
+        goto :break1 num_1 <= num;
+        write num_1 bank1 c;
+    } :break1 # 跳出循环用的标记
+    write num bank1 c;
+    op i i + 1;
+}
+control enabled switch1 true 0 0 0;
+
+#* 以上程序会生成的代码
+wait 0.1
+sensor _0 switch1 @enabled
+jump 0 notEqual _0 false
+read length cell1 0
+set i 1
+jump 20 greaterThanEq i length
+read num bank1 i
+set j i
+set c j
+op sub j j 1
+jump 17 lessThan j 0
+read num_1 bank1 j
+jump 17 lessThanEq num_1 num
+write num_1 bank1 c
+set c j
+op sub j j 1
+jump 11 greaterThanEq j 0
+write num bank1 c
+op add i i 1
+jump 6 lessThan i length
+control enabled switch1 true 0 0 0
+*#

examples/value.mdtlbl

@@ -0,0 +1,42 @@
+#*
+ * Value是Bang语言中的重要结构, 它是一个枚举, 可用值为一个Var或者一个DExp
+ * DExp的介绍请移步至dexp.mdtlbl
+ * Var是一个基本值单元, 它可以是一个变量, 一个字符串, 一个数字, 一个由@紧贴开头的变量
+ * 它有几个匹配分支:
+ *  普通标识符: 由一个下划线或者XID_Start开头, 0个及以上XID_Continue紧随其后
+ *      使用XID可以完成如中文标识符 日文标识符等
+ *  对象标识符: 在普通标识符的前方先匹配一个@, 同时XID_Continue部分可以匹配`-`符号
+ *      这是为了适应原游戏中的@开头的很多值如物品 环境变量 选项 枚举
+ *      短横线(`-`)符号是为了适应部分格式如`@abc-def`的值
+ *  原始标识符: 这种标识符的存在是为了适应mdt中奇葩的标识符界定的
+ *      mdt中标识符是连续的一段非空字符, 且不匹配内置值、字面量等即为标识符
+ *      所以使用原始标识符来适应这种奇葩, 格式为单引号包裹的一段连续非空字符
+ *      例如`'@abc%d*ef$ghi'`
+ *  数字: 普通数字, 除开头部分(小数部分开头也算)可以用下划线组成, 它会被忽略
+ *      格式为:
+ *          整数(`123`), 浮点数(`123.456`), 二进制数(`0b1011`), 十六进制数(`0x1f`),
+ *          负整数(`-123`), 负浮点数(`-123.456`), 负二进制数(`0b-1011`), 负十六进制数(`0x-1f`)
+ *          与mdt中数字格式基本相符
+ *  字符串: 由一个双引号起始, 一个双引号终止, 中间为0至若干个非双引号字符组成
+ *      如果其中包含换行, 将会被替换为一个字面量反斜杠接一个ASCII字符n
+ *
+ * 还有一种特殊数字, LiteralUInt, 这种数字会被真正编译时识别使用.
+ *  例如switch-case中, 必须是一个无符号非负不越界整数
+ *  这种数字并不被包含在Value中
+ *#
+
+set a 2;
+set @b 3;
+set @c-d 4;
+set 值 5;
+set _y 6;
+set 'ab%$&!@' 7;
+set str "8";
+set str_1 "9
+10"; # 跨行字符串
+set float 100_010.223_959;
+set n_float -100_010.223_959;
+set int 123_456;
+set n_int -123_456;
+set bin 0b1001_0010;
+set n_bin 0b-1001_0010;