跳到主要内容

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。