跳到主要内容

SCL 文本格式校验

本页说明何时以及如何在扫描逻辑中校验短文本。正则表达式引擎当前不可用。设备编号、批次码和简短命令应使用固定长度、固定位置和显式字符检查,保证执行时间可预测。

可用字符串函数​

函数参数返回值用途
STR_LEN(text)text: stringint返回字符数
CHAR_AT(text, index)text: string,index: intstring返回指定位置的单个字符;越界返回空字符串
STR_FIND(text, part)text: string,part: stringint返回首次出现位置;未找到返回 -1
STR_CMP(left, right)两个 stringint小于、等于、大于分别返回负数、0、正数
STR_TO_INT(text)text: stringint十进制文本转整数;失败返回 0
STR_TO_REAL(text)text: stringdouble数值文本转浮点数;失败返回 0.0

固定格式示例​

下面校验四位数字设备码。检查长度后再取字符,避免越界。

bool IsDigitAt(string text, int index)
{
string ch = CHAR_AT(text, index);
return STR_CMP(ch, "0") >= 0 && STR_CMP(ch, "9") <= 0;
}

bool IsDeviceCode(string code)
{
bool lengthOk = STR_LEN(code) == 4;
if (!lengthOk)
{
return false;
}

return IsDigitAt(code, 0)
&& IsDigitAt(code, 1)
&& IsDigitAt(code, 2)
&& IsDigitAt(code, 3);
}

bool valid = IsDeviceCode("1207");

选择规则​

  • 格式固定且很短:逐位置检查。
  • 只需判断前缀或分隔符:使用 STR_FIND 和 STR_LEN。
  • 需要转数值:先校验字符,再调用转换函数;转换失败与合法的零值相同,不能只看转换结果。
  • 规则复杂、长度不定或来自外部文件:在项目导入或通讯控制面完成校验,再把已验证结果交给 PLC 逻辑。

当前不可用​

  • Regex、模式编译和反向引用。
  • 扫描内按不确定长度反复搜索文本。
  • 把外部文件读入后再做正则匹配。