跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL DELETE — 删除字符串

SCL DELETE — 删除字符串

删除指定位置的一段字符。

字符串 S7-1200/1500 TIA V19 别名:删除字符串 / DELETE

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案:#Result := DELETE(IN := #Text, L := #Count, P := #Pos) 从第 P 个字符开始删除 L 个;L=0 不变,P 越界不变。

DELETE 从字符串的第 P 个字符开始删除 L 个字符:#Result := DELETE(IN := #Text, L := #Count, P := #Pos);。P 从 1 开始;L=0 不改变字符串,P 越界也不改变。

参数

参数方向类型存储区说明
IN输入STRING / WSTRINGD, L, P 或常量原字符串。
L输入BYTE / INT / SINT / USINTI, Q, M, D, L 或常量要删除的字符数。L=0 不改变字符串;L<0 返回空串。
P输入BYTE / INT / SINT / USINTI, Q, M, D, L 或常量删除起始位置,第一个字符是 1。P≤0 返回空串;P 超过长度不改变字符串。
Return返回值STRING / WSTRING—删除后的字符串。

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

最小示例

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

FB_Delete_Demo FB

最小示例 · 19 行 · 源文件 blocks/FB_Delete_Demo.scl

查看 FB_Delete_Demo 的块接口
区块名称类型说明
输入TextSTRING
输入PosInt
输入CountInt
输出ResultSTRING
blocks/FB_Delete_Demo.scl
1FUNCTION_BLOCK "FB_Delete_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Text : String;          // 原字符串
6      Pos : Int := 3;         // 删除起始位置
7      Count : Int := 4;       // 删除几个字符
8   END_VAR
9 
10   VAR_OUTPUT
11      Result : String;        // 删除后的字符串
12   END_VAR
13 
14BEGIN
15   REGION 删除字符
16      #Result := DELETE(IN := #Text, L := #Count, P := #Pos);
17   END_REGION
18END_FUNCTION_BLOCK
19 

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

SCL 写法

SCL
1#Result := DELETE(IN := #Text, L := #Count, P := #Pos);

典型用法:删掉固定前缀或分隔符:

SCL
1#WithoutPrefix := DELETE(IN := #Text, L := 2, P := 1);  // 去掉前两个字符

怎么工作

条件 结果
P=3, L=4 删除第 3~6 个字符
L=0 原字符串不变
P>LEN 原字符串不变
P≤0 空串
L<0 空串
L 超过剩余长度 从 P 删到末尾
  • P 是 1-based:第一个字符是 1。
  • L 是要删除的字符数,不是结束位置。
  • 删除后长度减少;目标 STRING[n] 的容量不变,有效长度变短。
  • STRING/WSTRING 都支持;中文宽字符用 WSTRING。

常用场景

1. 去掉固定前缀

协议报文前 2 个字符是站号;DELETE(IN := #Frame, L := 2, P := 1) 去掉站号得到数据部分。

2. 删除分隔符

已定位分隔符位置后,用 DELETE 删掉一个字符;比 REPLACE 更直接。

3. 清理非法字符

已知某个位置的字符需要删除;如果位置不固定,先用 FIND 定位。

常见坑

  • 把 P 当 0-based:第一个字符是 1;P=0 返回空串。
  • L 当结束位置:L 是长度,不是“删到第几个”;删到末尾用 LEN - P + 1。
  • P 越界:返回原字符串,不报错;不要用它判断操作是否发生。
  • L=0:不删除任何东西,返回原字符串。
  • 目标容量:删除不会增加长度,但目标 STRING[n] 仍要能容纳原字符串。
  • 中文按字节误解:STRING 是单字节字符,中文可能占多个字节;宽字符用 WSTRING。

和 LAD 的区别

LAD 的 DELETE 盒有 IN、L、P 和返回值;SCL 里直接写 DELETE(IN := ..., L := ..., P := ...)。语义一样,SCL 更容易和 FIND 组合做“先定位、再删除”。梯形图版本见 Learn-LAD 的 DELETE 页。

云仿真验证

PLC 云仿真:PASS(5 次扫描)。场景:从第 3 个字符删 4 个,边界情况。结果来自 PLC 云仿真 的 scl_run_scenario;页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  从第 3 个字符删 4 个,边界情况 (5 step(s), 5 scan(s))
RESULT: ALL PASS (5 scan(s))

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

验证状态

项目结果日期证据
构建期语法/结构校验PASS2026-11-02parse + validate
PLC 云仿真PASS(5 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/DELETE__Delete_characters_in_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

DELETE 的 P 从 0 还是 1 开始?

从 1 开始。P=3 表示从第三个字符开始删除;P=0 或负数返回空串。

L=0 会删除什么?

什么都不删,返回原字符串。P 越界时也不改变字符串。

删除后长度会变吗?

会减少 L 个字符(或减少到字符串末尾);目标 `STRING[n]` 容量不变,但有效长度变短。

← 返回 SCL 指令手册