SCL LEN — 字符串长度

LEN 返回字符串的当前有效字符数：#Length := LEN(IN := #Text);。空串返回 0；它查的不是 STRING[n] 里的最大容量 n。

1#Length := LEN(IN := #Text);

LEN 是带返回值的 FC，结果直接赋给 Int 变量：

1IF LEN(IN := #Message) > 20 THEN
2   // 消息太长，做截断或报警
3END_IF;

• LEN 只读字符串，不修改输入。
• 返回类型是 INT；字符串最大容量超过 INT 范围时，用 MAX_LEN 查容量。
• 字符串处理出错时，LEN 返回 0；0 也可能是空串，业务上要结合上下文判断。
• STRING 和 WSTRING 都支持；中文等宽字符建议用 WSTRING 保持字符计数稳定。

1. 判断消息是否为空

HMI 或通信收到一条文本，先用 LEN 判断是否为空，再决定是否解析。空串和“只有空格”是两件事，需要的话再配合 FIND 或去空格逻辑。

2. 限制显示/存储长度

在把字符串写入日志、CSV 或 HMI 之前，用 LEN 检查长度；超过目标容量就截断或报警，避免结果被静默截断。

3. 解析定长报文

如果协议规定“长度 + 内容”，可以先用 LEN 做完整性检查，再交给 LEFT、MID 或 FIND 解析。

• 把 LEN 当最大容量：STRING[20] 只存了 5 个字符时返回 5；最大容量用 MAX_LEN。
• 用 0 判断错误：空串也返回 0；不要只看 LEN=0 就认为指令出错。
• STRING 和 WSTRING 混用：类型不一致会编译报错；中文/宽字符用 WSTRING。
• 中文按字节误解：STRING 是单字节字符，中文可能占多个字节；需要按字符计数时确认字符集和类型。
• 字符串没初始化：未赋值的字符串可能不是空串；上电初始化或先赋 ''。
• 在表达式里重复调用：LEN 很便宜，但同一扫描多次调用不如先存到变量再复用。

LAD 的 LEN 盒只有一个 IN 输入和返回值；SCL 里直接写 LEN(IN := ...)，可以放在 IF、CASE 或赋值表达式里。语义一样，SCL 更适合把长度判断和后续解析写在一起。梯形图版本见 Learn-LAD 的 LEN 页。