📝 docs(tsl): expand syntax operator and object coverage

This commit is contained in:
csh
2026-06-10 15:25:42 +08:00
parent 540b3c0a1b
commit c0c2ffb6eb
6 changed files with 715 additions and 50 deletions
+36 -2
View File
@@ -17,7 +17,7 @@
1. 先判断任务需要条件分支、循环、`case`、异常处理还是调试跳转。
2. `if` / `for` / `while` / `repeat` 优先照本页文档骨架写,不要套用其他 Pascal 方言。
3. 生成带 `else` 的条件分支时,默认用 `begin ... end` 包住 `then``else` 分支,让分支内部语句正常以分号结尾;控制流块的 `end` 默认不加分号,也不要在 `else` 前提前加分号。
4. `case` 只按语句形态生成;不要把 `case` 放到赋值右侧生成表达式形态
4. `case` 可写成语句形态,也可写成赋值右侧的表达式形态;表达式形态的分支只能放单条表达式/单条语句,不写 `begin ... end` 语句段
5. 没有文档事实时不要发明控制流写法。
## 核心规则
@@ -27,7 +27,8 @@
- `for` 支持 `to``downto`、可选 `step`,以及 `for i, v in array` 遍历。
- `while``repeat ... until` 都可直接使用;`repeat` 至少会先执行一轮再判断结束条件。
- `break` 会跳出当前最近一层循环,`continue` 会跳过当前轮剩余语句。
- `case ... of ... else ... end` 作为语句形态生成;`end` 后默认不加分号。
- `case ... of ... else ... end` 作为语句形态生成;语句形态的 `end` 后默认不加分号。
- `value := case ... of ... else ... end;` 可作为表达式形态生成;表达式形态赋值语句本身要用分号结尾。
- `case` 分支标签支持逗号并列和 `to` 区间。
- `try ... except ... end` 可以捕获 `raise` 产生的错误,并继续执行后续语句。
- `exceptObject.errInfo``except` 块中可读,能拿到当前错误信息。
@@ -274,6 +275,39 @@ end
mid
```
`case` 表达式形态:
代码块身份:可直接照写示例
```tsl
a := 3;
label_value := case a of
1, 2:
"small";
3, 4:
"mid";
else
"other";
end;
writeLn(label_value);
```
输出说明:
- 输出 `mid`
代码块身份:输出片段
```text
mid
```
说明:
- 表达式形态可以放在赋值右侧。
- 表达式形态的每个分支只写单条表达式/单条语句,不写 `begin ... end` 语句段。
- 赋值语句整体以 `end;` 收尾。
### `try ... except`
代码块身份:可直接照写示例