SCL 类型转换
类型转换用于把输入数据变成控制逻辑需要的 bool、int 或 string;读取文本参数、生成状态文本或归一化开关值时使用。本页只列当前可执行的转换方式。源码使用 C# 风格 SCL,不要写成 Pascal 声明或块结束关键字。
| 转换 | 类别 | 访问 | 方式 | 失败行为 |
|---|---|---|---|---|
| 整数 → 布尔 | 比较表达式 | 求值 | rawState != 0 | — |
| 布尔 → 整数 | 条件运算符 | 求值 | ready ? 1 : 0 | — |
| 整数 → 字符串 | 标准函数 | 调用 | INT_TO_STR / INT_TO_STRING | — |
| 字符串 → 整数 | 标准函数 | 调用 | STR_TO_INT | 解析失败返回 0,不抛异常 |
| 数值强制转换 | 强制转换 | 求值 | (int)value | 浮点向零截断;无异常模型 |
整数转布尔
用明确比较表达式,不依赖隐式真假转换。
int rawState = 1;
bool active = rawState != 0;
0 得到 false,非 0 得到 true。
布尔转整数
使用条件运算符明确映射值。
bool ready = true;
int readyCode = ready ? 1 : 0;
条件运算符两侧应使用无副作用的值表达式。
整数转字符串
INT_TO_STR 和 INT_TO_STRING 都把整数转换为十进制字符串。
int partCount = 42;
string countText = INT_TO_STR(partCount);
string stateText = INT_TO_STRING(partCount);
两种名称的结果相同。新代码可统一使用 INT_TO_STR。
字符串转整数
STR_TO_INT 读取十进制整数文本。解析失败时返回 0,不会抛出异常。
string inputText = "120";
int setpoint = STR_TO_INT(inputText);
bool valid = setpoint != 0 || inputText == "0";
如果 0 是合法值,应同时检查原始文本或在上层先做输入校验,避免把无效文本和合法零混为一类。
数值强制转换
当前前端接受 C# 风格的内建数值转换,例如 (int)value。浮点转整数时向零截断;转换不会提供普通 .NET 的异常模型。
int source = 25;
int result = (int)source;
声明中的 int 当前是 16 位类型,而数值转换按运行时转换指令执行。涉及边界值时,应先检查范围,不要依赖溢出后的结果。
安全转换模式
string inputText = "50";
int requested = STR_TO_INT(inputText);
int minimum = 0;
int maximum = 100;
int accepted = requested;
if (requested < minimum)
{
accepted = minimum;
}
else if (requested > maximum)
{
accepted = maximum;
}
当前不提供的普通 C# 转换
当前公开子集不使用 Convert、Parse、TryParse、checked、异常捕获、可空返回值或用户类型强制转换。不要把普通 .NET 示例直接复制到 SCL。