SCL 数据类型
SCL 提供一组 C# 风格标量类型;声明变量、选择计数范围或处理文本时使用。本页列出当前编译前端的实际类型映射。源码写作 bool / int / string,不要改成 Pascal 的 BOOL / INT / STRING 声明。
常用类型
| 写法 | 类别 | 访问 | 实际类型 | 位宽 | 用途 |
|---|---|---|---|---|---|
bool | 布尔 | 读写 | 布尔 | 1 | 启停、互锁、报警 |
sbyte | 有符号整数 | 读写 | 有符号整数 | 8 | 小范围偏差 |
byte | 无符号整数 | 读写 | 无符号整数 | 8 | 字节和掩码 |
short | 有符号整数 | 读写 | 有符号整数 | 16 | 小范围整数 |
ushort | 无符号整数 | 读写 | 无符号整数 | 16 | 非负小范围整数 |
int | 有符号整数 | 读写 | 有符号整数 | 16 | 模式、小范围计数 |
uint | 无符号整数 | 读写 | 无符号整数 | 16 | 非负小范围计数 |
long | 有符号整数 | 读写 | 有符号整数 | 64 | 大范围累计值 |
ulong | 无符号整数 | 读写 | 无符号整数 | 64 | 大范围非负累计值 |
float | 浮点数 | 读写 | 浮点数 | 32 | 模拟量和普通计算 |
double | 浮点数 | 读写 | 浮点数 | 64 | 高精度计算 |
char | 字符 | 读写 | 整数字符码 | 16 | 单字符码值 |
string | 字符串 | 读写 | 字符串 | — | 状态文本、设备代码 |
int 与大整数范围当前 SCL 声明中的 int 映射到 16 位有符号整数,范围是 -32768 到 32767,不是普通 .NET 的 32 位 int。long 和 ulong 虽声明为 64 位,当前运行时只保证绝对值不超过 2^53 的整数逐值精确;超出时不要用于要求每一位都准确的累计计数。
布尔
bool 只有 true 和 false 两个值。
bool enabled = true;
bool alarm = false;
bool permit = enabled && !alarm;
布尔值用于条件、互锁和状态。不要用整数代替布尔状态。
整数
int mode = 1;
int partCount = 0;
int errorCode = -1;
partCount = partCount + 1;
选择整数类型时先估算最大值、最小值和累计时间。计数器可能长期增长时,不要使用范围过小的类型。
字符串
string machineState = "Stopped";
string stationName = "上料站";
string emptyText = "";
字符串适合状态文本和短标识,不应放在高频数值计算路径中。字符串使用双引号,比较使用 == 或 !=。
string expected = "Ready";
bool matched = expected == "Ready";
字面量与类型
| 字面量 | 类别 | 访问 | 默认含义 |
|---|---|---|---|
10 | 整数 | 只读 | 整数 |
0x10 | 整数 | 只读 | 十六进制整数 |
0b1010 | 整数 | 只读 | 二进制整数 |
1.5f | 浮点数 | 只读 | 32 位浮点 |
1.5 | 浮点数 | 只读 | 64 位浮点 |
true、false | 布尔 | 只读 | 布尔 |
"Ready" | 字符串 | 只读 | 字符串 |
数值后缀和更宽类型可用,但教程示例优先使用 int,便于先掌握控制逻辑。
类型选择
| 数据含义 | 类别 | 访问 | 建议 |
|---|---|---|---|
| 开关、允许、故障 | 布尔 | 读写 | bool |
| 模式、小范围计数 | 有符号整数 | 读写 | int |
| 超出 16 位范围的累计值 | 有符号整数 | 读写 | 更宽整数类型 |
| 模拟量和比例计算 | 浮点数 | 读写 | float 或 double |
| 状态文本、设备代码 | 字符串 | 读写 | string |
不属于当前公开子集
当前教程不使用 decimal、可空类型、dynamic、托管对象或运行时集合。这些普通 C# 能力不能直接当作 SCL 能力使用。也不要写成 Pascal 的 ARRAY [...] OF 或 STRUCT ... END_STRUCT;源码数组和源码 struct 当前不属于 C# 风格公开子集。