SCL 基本语法
SCL 采用 C# 风格语法,规范名是 SCL。新建程序、修改控制逻辑或排查编译错误时,可用本页核对注释、标识符、字面量、语句和代码块。不要写成 Pascal 的 END_IF / END_FOR / :=。
| 要素 | 类别 | 访问 | 写法 |
|---|---|---|---|
| 注释 | 源码说明 | 只读 | // 到行尾 |
| 标识符 | 命名 | 读写绑定 | 字母、数字、下划线、中文 |
| 字面量 | 常量值 | 只读 | true、1250、"Ready" |
| 变量声明 | 声明 | 读写 | type name; 或 type name = value; |
| 赋值 | 语句 | 写入 | = |
| 比较 | 表达式 | 求值 | ==、!= |
| 代码块 | 结构 | — | { } |
| 语句结束 | 结构 | — | ; |
注释
// 行注释从双斜线开始,到本行结束
bool enabled = true; // 也可以写在语句后面
教程示例统一使用 //。块注释也可被编译器识别,但控制程序中优先使用短行注释,便于逐行审查。
标识符
变量名、方法名和类型名可以使用字母、数字、下划线与中文字符。
规则:
- 不能以数字开头。
- 区分大小写。
- 不能使用
if、for、bool等关键字。 - 长期维护的变量应表达设备或工艺含义。
bool motorReady = false;
int partCount = 0;
string stationName = "上料站";
字面量
bool ready = true;
bool fault = false;
int decimalValue = 1250;
int hexMask = 0x00FF;
int binaryMask = 0b1010;
string stateText = "Ready";
整数字面量支持十进制、十六进制、二进制和数字分组下划线。字符串使用双引号,可使用 \n、\t、\r、\ 和 \" 转义。
int largeCount = 30_000;
string twoLines = "Line1\nLine2";
字符串不能跨物理行。当前公开子集不使用字符串插值、逐字字符串或可空字符串语法。
变量声明
bool runCommand;
int targetSpeed = 100;
string stateText = "Stopped";
一条声明可只写类型和名称,也可用 = 设置初值。为减少歧义,带初值时建议每行只声明一个变量。
赋值与比较
int actual = 10;
int target = 10;
bool reached = false;
reached = actual == target;
=:把右侧值写入左侧变量。==:比较两侧是否相等,结果为bool。!=:比较两侧是否不相等。
代码块
条件、循环、方法和类体都使用 { }。编译器可接受部分单语句省略花括号的写法,但工程代码应始终保留花括号。
bool guardClosed = true;
bool pressureOk = true;
bool permit = false;
if (guardClosed && pressureOk)
{
permit = true;
}
else
{
permit = false;
}
语句结束
声明、赋值、调用、break、continue 和 return 以 ; 结束。if、for、while 和类体的右花括号后不加分号。
int count = 0;
while (count < 3)
{
count = count + 1;
}
条件表达式
条件应明确产生 bool。不要依赖数值自动转成真假。
int errorCode = 0;
bool healthy = false;
bool fault = false;
bool enabled = false;
healthy = errorCode == 0;
if (healthy && !fault)
{
enabled = true;
}
&& 和 || 的两侧都会求值。需要控制调用顺序时使用嵌套 if。
程序结构
简单代码段可使用顶层变量和顶层语句;需要复用或保存实例状态时,使用类、字段和方法。
class CounterBlock
{
private int value = 0;
public int Value { get; set; }
public void Execute(bool enable)
{
if (enable)
{
value = value + 1;
}
Value = value;
}
}
CounterBlock counter = new CounterBlock();
bool countEnable = true;
counter.Execute(countEnable);
当前公开子集的边界
以下写法不属于本教程公开子集:
- 异常处理和抛出异常。
- 线程、任务、锁和异步方法。
- 运行时堆分配;实例和数组应在声明处建立。
- 动态类型、可空类型和运行时反射对象。
- 委托、事件、闭包和运行时 LINQ。
- 文件作用域命名空间和预处理指令。
遇到编译错误时,先处理第一条诊断,再检查分号、花括号、变量声明和类型。