SCL 变量作用域
作用域决定变量在哪些语句中可见;拆分方法、条件块或有状态功能块时需要核对。本页按顶层、代码块、参数和实例字段说明。规范名是 SCL,源码使用 C# 风格类、方法和访问级别,不要写成 Pascal 的 VAR / VAR_INPUT。
顶层作用域
顶层变量可供同一代码段的顶层语句使用,适合保存扫描状态。
bool runState = false;
int cycleCount = 0;
string stateText = "Stopped";
if (runState)
{
cycleCount = cycleCount + 1;
stateText = "Running";
}
顶层变量会参与项目的运行状态,不应随意复用为临时值。
代码块作用域
在 { } 内声明的变量,只应在该块中使用。
int result = 0;
bool enabled = true;
if (enabled)
{
int increment = 5;
result = result + increment;
}
// increment 在此处不可使用
为避免扁平化代码中的名称冲突,不要在内外层重复声明同名变量。
方法参数
参数在整个方法体内可见。默认参数按值传入。
class MathTools
{
public int Add(int left, int right)
{
int result = left + right;
return result;
}
}
需要把结果写回调用方时,可使用已声明的 out 或 ref 参数。
class CounterTools
{
public void Increment(ref int value, bool enabled)
{
if (enabled)
{
value = value + 1;
}
}
}
CounterTools tools = new CounterTools();
int count = 0;
bool countEnable = true;
tools.Increment(ref count, countEnable);
调用点不能在 out 后内联声明变量;应先声明,再传入。
方法局部变量
局部变量用于一次方法调用中的中间结果。不要用局部变量保存必须跨扫描保留的设备状态。
class TextTools
{
public string SelectState(bool running, bool fault)
{
string result = "Stopped";
if (fault)
{
result = "Fault";
}
else if (running)
{
result = "Running";
}
return result;
}
}
功能块字段
类字段属于实例。相同类型的两个实例各自保存一份字段状态。
class LatchBlock
{
private bool state = false;
public bool Q { get; set; }
public void Execute(bool setCommand, bool resetCommand)
{
if (resetCommand)
{
state = false;
}
else if (setCommand)
{
state = true;
}
Q = state;
}
}
LatchBlock first = new LatchBlock();
LatchBlock second = new LatchBlock();
访问级别
| 修饰符 | 类别 | 访问 | 可见范围 |
|---|---|---|---|
public | 访问级别 | 读写 | 调用方可访问 |
private | 访问级别 | 读写(仅类内) | 仅当前类可访问 |
protected | 访问级别 | 读写(类与派生类) | 当前类和派生类可访问 |
internal | 访问级别 | 读写(当前项目) | 当前项目内可访问 |
设备状态字段通常保持 private,通过公开方法和输出属性访问。
作用域检查
- 临时变量不逃出声明它的
{ }。 - 不在嵌套块重复声明同名变量。
- 跨扫描状态使用顶层变量或实例字段。
out和ref实参先声明且可写。- 两个设备对象使用两个独立功能块实例。