跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL LEFT — 取左字符串

SCL LEFT — 取左字符串

取左边 N 个字符。

字符串 S7-1200/1500 TIA V19 别名：左字符串 / LEFT

在 TIA 里试一下

通过 TiaLink 把本页示例（FB_Left_Demo）作为“外部源”导入你当前打开的 TIA Portal 项目：预检、生成块、编译，并清理外部源。导入后不会自动保存；FB 导入后需要在 OB 里调用。

TiaLink 设置

默认 http://localhost:8080。也可以在本页地址后加 ?tialink= 临时指定。

TiaLink 启动时若设置了 --api-token，这里要填相同的值；只保存在本机浏览器 localStorage，不会上传。

一句话

答案：#Result := LEFT(IN := #Text, L := #Count) 从左边取 L 个字符；L≤0 返回空串，L 超过长度返回整个字符串。

LEFT 从字符串左边取 L 个字符：#Result := LEFT(IN := #Text, L := #Count);。L 是字符个数，不是起始位置；L≤0 返回空串，L 超过长度返回整个字符串。

参数

参数方向类型存储区说明
IN输入STRING / WSTRINGD, L, P 或常量源字符串。
L输入BYTE / INT / SINT / USINTI, Q, M, D, L 或常量从左边取多少个字符。L ≤ 0 返回空串；L 大于字符串长度时返回整个字符串。
Return返回值STRING / WSTRING—取出的左边子串。

参数表以 TIA Portal V19 帮助为事实核对；S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围，实际可用范围还受块接口和优化属性影响。

最小示例

下面是一个完整块，页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过，输出见“云仿真验证”。

FB_Left_Demo FB

最小示例 · 18 行 · 源文件 blocks/FB_Left_Demo.scl

查看 FB_Left_Demo 的块接口
区块名称类型说明
输入TextSTRING
输入CountInt
输出ResultSTRING
blocks/FB_Left_Demo.scl
1FUNCTION_BLOCK "FB_Left_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Text : String;          // 源字符串
6      Count : Int := 4;       // 从左边取几个字符
7   END_VAR
8 
9   VAR_OUTPUT
10      Result : String;        // 左边子串
11   END_VAR
12 
13BEGIN
14   REGION 取左边字符
15      #Result := LEFT(IN := #Text, L := #Count);
16   END_REGION
17END_FUNCTION_BLOCK
18

块接口表由源码自动生成；# 前缀表示块内局部变量，实际工程里也可以是全局标签或 DB 变量。

SCL 写法

SCL
1#Result := LEFT(IN := #Text, L := #Count);

常见用法是取固定前缀：

SCL
1#Prefix := LEFT(IN := #OrderNo, L := 2);  // 例如 'AB202601' -> 'AB'

怎么工作

L 结果
≤ 0 空串 ''
1 第一个字符
小于长度 左边 L 个字符
≥ 长度 整个字符串
空输入 空串
  • L 是“取几个字符”，不是“从第几个开始”；起始位置固定是第一个字符。
  • 结果长度不会超过 L，也不会超过源字符串长度。
  • 目标字符串容量不够时，结果会被截断到目标容量；声明 String 时默认容量 254。
  • STRING/WSTRING 都支持；中文宽字符用 WSTRING。

常用场景

1. 取订单/批次前缀

订单号 AB202601 前两位是工厂代码；LEFT(IN := #OrderNo, L := 2) 取出 AB，再配合 FIND 或 MID 取日期部分。

2. 截断 HMI 显示

消息太长时只显示前 20 个字符；先 LEFT 再显示，避免 HMI 控件溢出。注意这只是显示截断，原始消息仍保留。

3. 解析固定格式报文

协议前 4 个字符是命令字；LEFT 取出来后用 CASE 分发，剩余部分用 MID 取。

常见坑

  • 把 L 当起始位置：LEFT 没有起始位置参数；从第 N 个字符开始用 MID。
  • L=0 返回空串：协议里空串可能被当成“无数据”，先判断再使用。
  • L 超过长度：返回整串，不会补空格；不要依赖固定长度做补齐。
  • 目标容量不够：结果会被截断；先算好目标 STRING[n] 的 n。
  • 中文按字节误解：STRING 是单字节字符，中文可能占多个字节；宽字符用 WSTRING。
  • 空输入：返回空串，不会报错；业务上要区分“空”和“解析失败”。

和 LAD 的区别

LAD 的 LEFT 盒有 IN、L 和返回值；SCL 里直接写 LEFT(IN := ..., L := ...)，可以嵌在表达式里。语义一样，SCL 更容易和 FIND、MID 组合做解析。梯形图版本见 Learn-LAD 的 LEFT 页。

云仿真验证

PLC 云仿真：PASS（4 次扫描）。场景：取前 4 个字符，边界情况。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  取前 4 个字符，边界情况 (4 step(s), 4 scan(s))
RESULT: ALL PASS (4 scan(s))

云仿真验证语法、结构和逐扫描行为，不等同于 TIA 编译；TIA 状态见下方“验证状态”。

验证状态

项目结果日期证据
构建期语法/结构校验PASS2026-11-02parse + validate
PLC 云仿真PASS（4 scans）2026-11-02scl_run_scenario / scl_validate
TIA 导入编译待实测—TiaLink + TIA Portal（待实测）

“待实测”表示还没有在 TIA Portal 里导入编译，不代表代码有问题；上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行，不替代 TIA 编译。

来源与说明

参数、行为和数据类型的核对来源：TIA Portal V19 帮助的 Instructions/Instructions/Extended_instructions/String_+_Char/LEFT__Read_the_left_character_of_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

参数、位置和边界规则以 TIA Portal V19 帮助为事实核对；中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

Siemens 文档与截图的版权归 Siemens；本站只引用事实参数，不复制官方描述段落和图片。官方参考：Siemens TIA Portal。

常见问题

LEFT 的 L 是从 0 还是 1 开始？

L 是“取几个字符”，不是起始位置。L=1 取第一个字符，L=4 取前四个字符。

L 大于字符串长度会怎样？

返回整个字符串，不会补空格，也不会报错。

L=0 或负数呢？

返回空串。做协议解析时先判断 L，避免把空串当成有效内容。

← 返回 SCL 指令手册