跳到主要内容

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# 风格公开子集。