SCL 文本格式校验
本页说明何时以及如何在扫描逻辑中校验短文本。正则表达式引擎当前不可用。设备编号、批次码和简短命令应使用固定长度、固定位置和显式字符检查,保证执行时间可预测。
可用字符串函数
| 函数 | 参数 | 返回值 | 用途 |
|---|---|---|---|
STR_LEN(text) | text: string | int | 返回字符数 |
CHAR_AT(text, index) | text: string,index: int | string | 返回指定位置的单个字符;越界返回空字符串 |
STR_FIND(text, part) | text: string,part: string | int | 返回首次出现位置;未找到返回 -1 |
STR_CMP(left, right) | 两个 string | int | 小于、等于、大于分别返回负数、0、正数 |
STR_TO_INT(text) | text: string | int | 十进制文本转整数;失败返回 0 |
STR_TO_REAL(text) | text: string | double | 数值文本转浮点数;失败返回 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、模式编译和反向引用。- 扫描内按不确定长度反复搜索文本。
- 把外部文件读入后再做正则匹配。