跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL INSERT — 插入字符串

SCL INSERT — 插入字符串

在指定位置插入字符串。

字符串 S7-1200/1500 TIA V19 别名：插入字符串 / INSERT

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案：#Result := INSERT(IN1 := #Text, IN2 := #Insert, P := #Pos) 在第 P 个字符之后插入；P=0 插到开头，P 大于等于长度插到末尾。

INSERT 把第二个字符串插到第一个字符串的指定位置：#Result := INSERT(IN1 := #Text, IN2 := #Insert, P := #Pos);。P=0 插到开头，P 大于等于原长度插到末尾。

参数

参数方向类型存储区说明
IN1输入STRING / WSTRINGD, L, P 或常量原字符串。
IN2输入STRING / WSTRINGD, L, P 或常量要插入的字符串。
P输入BYTE / INT / SINT / USINTI, Q, M, D, L 或常量插入位置。P=0 插到开头；P 大于等于原长度插到末尾；P<0 返回空串。
Return返回值STRING / WSTRING—插入后的字符串。

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

最小示例

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

FB_Insert_Demo FB

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

查看 FB_Insert_Demo 的块接口
区块名称类型说明
输入TextSTRING
输入InsertSTRING
输入PosInt
输出ResultSTRING
blocks/FB_Insert_Demo.scl
1FUNCTION_BLOCK "FB_Insert_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Text : String;          // 原字符串
6      Insert : String;        // 要插入的字符串
7      Pos : Int := 3;         // 插入位置
8   END_VAR
9 
10   VAR_OUTPUT
11      Result : String;        // 插入后的字符串
12   END_VAR
13 
14BEGIN
15   REGION 插入字符串
16      #Result := INSERT(IN1 := #Text, IN2 := #Insert, P := #Pos);
17   END_REGION
18END_FUNCTION_BLOCK
19

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

SCL 写法

SCL
1#Result := INSERT(IN1 := #Text, IN2 := #Insert, P := #Pos);

常见用法：已知位置时插入分隔符或前缀：

SCL
1#WithDash := INSERT(IN1 := #OrderNo, IN2 := '-', P := 2);  // 'AB202601' -> 'AB-202601'

怎么工作

P 结果
0 插到最前面
1 插到第 1 个字符之后
3 插到第 3 个字符之后
≥ 原长度 追加到末尾
< 0 空串
  • P 是插入位置，字符插到第 P 个字符之后；不是“插到第 P 个字符之前”。
  • 插入空串不改变结果。
  • 结果长度 = 原长度 + 插入长度；目标字符串容量不够时会被截断。
  • STRING/WSTRING 都支持；中文宽字符用 WSTRING。

常用场景

1. 插入分隔符

订单号 AB202601 在第 2 个字符后插入 - 得到 AB-202601；适合固定格式的显示。

2. 插入前缀/后缀

给文件名或消息加前缀；前缀用 P=0，后缀用 P=LEN 或更大的值。

3. 修复/补全文本

解析出错时在固定位置插入占位符；要确保目标 STRING[n] 足够长。

常见坑

  • 把 P 当“之前插入”：TIA 的规则是插到第 P 个字符之后；要插到开头用 P=0。
  • P 超过长度：会追加到末尾，不会报错；要严格控制时先 LEN。
  • 目标容量不够：插入后变长，结果可能被截断；先算好 STRING[n]。
  • P<0：返回空串；不要用负数表示“末尾”。
  • 插入空串：结果不变，不是错误。
  • 中文按字节误解：STRING 是单字节字符，中文可能占多个字节；宽字符用 WSTRING。

和 LAD 的区别

LAD 的 INSERT 盒有 IN1、IN2、P 和返回值；SCL 里直接写 INSERT(IN1 := ..., IN2 := ..., P := ...)。语义一样，SCL 更容易和 FIND 组合做定位插入。梯形图版本见 Learn-LAD 的 INSERT 页。

云仿真验证

PLC 云仿真：PASS（4 次扫描）。场景：中间插入、开头插入、末尾追加。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  中间插入、开头插入、末尾追加 (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/INSERT__Insert_characters_in_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

INSERT 的 P 是插入到第 P 个字符之前还是之后？

按 TIA 帮助的规则，P 表示插入位置，字符会插到第 P 个字符之后；P=0 表示插到最前面。

P 超过字符串长度会怎样？

插到末尾，相当于追加；不会报错。要严格控制位置时先用 LEN 判断。

插入后长度会变吗？

会，结果长度 = 原长度 + 插入字符串长度；目标 `STRING[n]` 的 n 要够大，否则结果会被截断。

← 返回 SCL 指令手册