枚举
枚举适合设备模式、步骤和错误码。当前 C# 风格 SCL 支持顶层整数枚举、显式整数值、Type.Member 访问和 switch。
类别
| 类别 | 符号 | 可用性 | 说明 |
|---|---|---|---|
| 顶层枚举 | enum | 可执行 | 编译单元顶层或命名空间内声明 |
| 类内枚举 | 嵌在 class 中的 enum | 不可用 | 只把顶层 enum 登记为类型 |
| 整数字面量成员 | Idle = 0 | 可执行 | 正、负整数常量 |
| 常量表达式成员 | A + B 等 | 不可用 | 成员值须整数字面量 |
| 运行时枚举 API | Enum.IsDefined、typeof | 不可用 | 没有反射合同 |
访问
| 名称 | 访问 | 当前合同 |
|---|---|---|
| 类型名 | 声明 | enum MachineState { ... } |
| 成员 | Type.Member | 如 MachineState.Idle |
比较 / 位运算 / switch | 可读 | 按整数值参与 |
| 未赋值成员 | 自动递增 | 从前一个值加 1;首个默认 0 |
| 底层类型标注 | 可写但忽略 | enum E : int 被消费,不改变整数值语义 |
enum MachineState
{
Idle = 0,
Running = 10,
Fault = 20
}
class MachineControl
{
MachineState State = MachineState.Idle;
bool MotorRun;
int AlarmCode;
string StatusText = "空闲";
public void Execute(bool startCommand, bool faultActive, bool resetCommand)
{
switch (State)
{
case MachineState.Idle:
MotorRun = false;
StatusText = "空闲";
if (startCommand && !faultActive)
{
State = MachineState.Running;
}
break;
case MachineState.Running:
MotorRun = true;
StatusText = "运行";
if (faultActive)
{
State = MachineState.Fault;
AlarmCode = 20;
}
break;
case MachineState.Fault:
MotorRun = false;
StatusText = "故障";
if (resetCommand && !faultActive)
{
State = MachineState.Idle;
AlarmCode = 0;
}
break;
default:
State = MachineState.Fault;
MotorRun = false;
AlarmCode = 99;
break;
}
}
}
为 0 定义安全默认状态。switch 保留 default,未知值进入安全态。状态值一旦用于持久化或通讯后不要随意改动。