跳到主要内容

字符串

字符串适合设备名称、状态标签和简短诊断。控制条件仍应使用 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)调用intUTF-16 代码单元数;空串返回 0
CHAR_AT(s, index)调用string零基单代码单元;越界返回空串
string.Find(s, needle)调用intOrdinal 首次位置;未找到返回 -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)调用stringOrdinal 替换全部;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。二进制载荷交给通讯层,不要先转成字符串。