SCL 常量
常量用于给限值、模式号和固定文本命名;一个值在程序设计上不应变化时使用 const。当前前端接受 C# 风格声明,但只读检查尚未在所有位置强制。规范名是 SCL,不要写成 Pascal 的 CONSTANT ... END_CONSTANT。
声明
常量在声明时必须用 = 给出初值。
const int MaxSpeed = 3000;
const int MaxRetries = 3;
const string ReadyText = "Ready";
const bool FeatureEnabled = true;
命名建议使用清楚的 PascalCase 或项目统一规则,不要只写缩写。
使用固定限值
const int MinSpeed = 0;
const int MaxSpeed = 3000;
int requestedSpeed = 3500;
int commandSpeed = requestedSpeed;
if (commandSpeed < MinSpeed)
{
commandSpeed = MinSpeed;
}
else if (commandSpeed > MaxSpeed)
{
commandSpeed = MaxSpeed;
}
使用状态常量
const int StateStopped = 0;
const int StateRunning = 1;
const int StateFault = 2;
int state = StateStopped;
string stateText = "Stopped";
bool fault = false;
bool runCommand = false;
if (fault)
{
state = StateFault;
stateText = "Fault";
}
else if (runCommand)
{
state = StateRunning;
stateText = "Running";
}
状态较多时可使用枚举;简单模式号可使用 const int。
常量表达式
简单整数表达式可用于固定计算。
const int SecondsPerMinute = 60;
const int HalfHourSeconds = 30 * SecondsPerMinute;
int timeoutSeconds = HalfHourSeconds;
当前约束
当前 C# 前端会识别 const 声明和常量整数值,但并非所有作用域都会可靠拒绝后续赋值。因此:
- 把
const名称当作只读符号。 - 不在后续语句中给常量名赋值。
- 关键安全限值还应由项目校验和现场配置共同约束。
- 不把普通变量仅靠命名伪装成常量。
const int AlarmLimit = 100;
int measured = 95;
bool alarm = measured >= AlarmLimit;
常量与变量
| 需求 | 类别 | 访问 | 写法 |
|---|---|---|---|
| 固定限值、模式号、固定文本 | 常量 | 只读 | const |
| 扫描中会变化的状态 | 变量 | 读写 | 普通变量 |
| 需要跨扫描记忆的状态 | 扫描状态 | 读写 | 顶层变量或功能块字段 |
| 现场可调整参数 | 项目参数 | 读写 | 项目参数,不应写死为常量 |