3.2 KiB
3.2 KiB
Introduction
文档类型:语法主线 是否可直接用于生成代码:仅部分 是否含已验证可执行示例:是 是否含已验证反例:否 遇到不确定时跳转到:02_quickstart.md、03_core_model.md、12_pitfalls.md
手册位置:第 1 篇,共 32 篇。上一篇:手册入口 index.md。下一篇:02_quickstart.md。
这一篇只做一件事:让新 session 在看到 TSL 时,先用正确的读法建立心智模型。
这一篇解决什么问题
回答“第一次读 TSL 时,应该先把它当成什么来理解,以及最容易和别的语言混淆的差异是什么”。
涉及赋值、命名参数、类外形、unit 骨架、数组 / 字符串下标这类高频硬规则时,统一以 02_quickstart.md 的“语言核心事实速查”为准;这一页只负责建立第一印象。
先用什么方式读 TSL
- 可以先按 Pascal 风格语言去读它:常见外形是
function ... begin ... end;、unit ... interface ... implementation ... end.、type Name = class ... end;;但这里只借外形,不默认继承 Pascal 的全部语义、库习惯和文件模型。 - 先看顶层主体,再看细节;不要先被文件扩展名带偏。
- 当前手册把顶层主体优先收敛成四类:松散语句、顶层
function / procedure、顶层type Name = class、顶层unit。 - 顶层
uses可以出现,但这里只把它当成辅助组织语句,不把它当成主体声明。 - 日常赋值先记
:=,不要把=当成普通赋值。
第一次写时最容易混淆的差异
array(...)既可以当顺序数组,也可以当字符串键表。- 数组下标从
0开始,字符串下标从1开始。 - 顶层类定义按
type Name = class ... end;去写,不使用裸class Name。 - 调用函数时,命名参数写成
name: value,例如Demo(a: 1, b: 2)。
已验证的第一印象
最常见的 function / procedure 外形:
代码块身份:已验证可执行示例
function Demo();
begin
return 1;
end;
procedure LogDemo(msg);
begin
WriteLn(msg);
end;
赋值、数组、字符串下标的第一印象:
代码块身份:已验证可执行示例
items := array(10, 20, 30);
table_data := array("Code": "000001", "Name": "Demo");
first_item := items[0];
first_char := "ABC"[1];
类的第一印象:
代码块身份:已验证可执行示例
type DemoType = class
end;
unit 的第一印象:
代码块身份:已验证可执行示例
unit DemoUnit;
interface
function Demo();
implementation
function Demo();
begin
return 1;
end;
end.
下一步怎么读
- 需要立刻开始写代码:看 02_quickstart.md
- 需要判断当前文件属于哪一种顶层模型:看 03_core_model.md
- 需要先写值、数组、字符串:看 04_values_and_literals.md
- 需要先写变量、常量:看 05_variables_and_constants.md
- 需要先写函数和调用:看 06_functions_and_calls.md