跳到主要内容

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。
  • 文件作用域命名空间和预处理指令。

遇到编译错误时,先处理第一条诊断,再检查分号、花括号、变量声明和类型。