字符串
字符串适合设备名称、状态标签和简短诊断。控制条件仍应使用 bool、int 或枚举。字符串是受限的 PLC 文本值,不是 .NET 对象。
类别
| 类别 | 符号 | 可用性 | 说明 |
|---|---|---|---|
| 语言语法 | string 声明、字面量、赋值 | 可执行 | 双引号字面量;比较用 == / != |
| 长度与查找 | string.Len、CHAR_AT、string.Find、string.Cmp | 可执行 | 无状态标准函数 |
| 截取 | string.Left、string.Right、string.Mid | 可执行 | 第三个参数是长度 |
| 拼接与改写 | string.Concat、Insert、Delete、Replace、Cpy | 可执行 | 返回新值,不原地修改 |
| 清理与大小写 | Trim、TrimStart、TrimEnd、Upper、Lower | 可执行 | 不依赖系统区域设置 |
| 受限格式化 | string.Format | 可执行 | 只替换一个 {0} |
| 数值转换 | INT_TO_STR、REAL_TO_STR、STR_TO_INT、STR_TO_REAL | 可执行 | 失败返回零 |
| 实例成员 | text.Length、text[i]、Substring | 不可用 | 不要套用 .NET 字符串 API |
IEC 别名 LEN / STR_LEN、LEFT / STR_LEFT 等与对应 string.* 调用产物一致。教程优先写 string.*。
访问
| 符号 | 访问 | 返回 | 说明 |
|---|---|---|---|
string.Len(s) | 调用 | int | UTF-16 代码单元数;空串返回 0 |
CHAR_AT(s, index) | 调用 | string | 零基单代码单元;越界返回空串 |
string.Find(s, needle) | 调用 | int | Ordinal 首次位置;未找到返回 -1 |
string.Cmp(a, b) | 调用 | int | 小于 -1,相等 0,大于 1 |
string.Left(s, count) | 调用 | string | 左侧 count 个代码单元 |
string.Right(s, count) | 调用 | string | 右侧 count 个代码单元 |
string.Mid(s, start, count) | 调用 | string | 从零基 start 取 count 个;count 不是结束索引 |
string.Concat(a, b, ...) | 调用 | string | 至少两个字符串实参 |
string.Insert(s, pos, sub) | 调用 | string | 在零基 pos 插入 |
string.Delete(s, pos, count) | 调用 | string | 从 pos 删除 count 个 |
string.Replace(s, old, replacement) | 调用 | string | Ordinal 替换全部;old 为空或找不到时返回原串 |
string.Cpy(s) | 调用 | string | 内容相同的新值 |
string.Trim(s) | 调用 | string | 去除首尾空白 |
string.TrimStart(s) | 调用 | string | 去除开头空白 |
string.TrimEnd(s) | 调用 | string | 去除结尾空白 |
string.Upper(s) | 调用 | string | 不依赖区域设置转大写 |
string.Lower(s) | 调用 | string | 不依赖区域设置转小写 |
string.Format(format, arg) | 调用 | string | 只把 {0} 换成一个字符串参数 |
INT_TO_STR(value) | 调用 | string | 十进制,不依赖区域设置 |
REAL_TO_STR(value) | 调用 | string | 往返格式,不依赖区域设置 |
STR_TO_INT(s) | 调用 | int | 解析失败返回 0 |
STR_TO_REAL(s) | 调用 | double | 小数点为 .;失败返回 0.0 |
这些调用没有实例状态,不要写成 text.Substring(...),也不要为截取文本创建功能块实例。
string message = "DARRA-PLC";
int length = string.Len(message);
int separator = string.Find(message, "-");
string firstChar = CHAR_AT(message, 0);
string prefix = string.Left(message, 5);
string middle = string.Mid(message, 6, 3);
if (separator >= 0)
{
string display = string.Concat("设备: ", message);
}
Find 返回 -1 时不能继续当索引。Mid 的第三个参数是长度。转换失败返回零,不能区分合法零和格式错误;来自通讯或操作员的文本应先由上层校验。
索引单位是 UTF-16 代码单元。常用中文通常占 1 个;部分扩展字符占 2 个,CHAR_AT 可能只返回代理项的一半。不要在高速扫描中持续拼接变化文本;报警文案放到慢速任务或 HMI/Service。二进制载荷交给通讯层,不要先转成字符串。