跳到主要内容

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
扫描中会变化的状态变量读写普通变量
需要跨扫描记忆的状态扫描状态读写顶层变量或功能块字段
现场可调整参数项目参数读写项目参数,不应写死为常量