跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL REPLACE — 替换字符串

SCL REPLACE — 替换字符串

替换指定位置的一段字符。

字符串 S7-1200/1500 TIA V19 别名：替换字符串 / REPLACE

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案：#Result := REPLACE(IN1 := #Text, IN2 := #New, L := #Count, P := #Pos) 从第 P 个字符开始，用 IN2 替换 L 个字符；L=0 表示插入。

REPLACE 从第 P 个字符开始，用 IN2 替换 L 个旧字符：#Result := REPLACE(IN1 := #Text, IN2 := #New, L := #Count, P := #Pos);。L=0 表示不替换、直接插入。

参数

参数方向类型存储区说明
IN1输入STRING / WSTRINGD, L, P 或常量原字符串。
IN2输入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_Replace_Demo FB

最小示例 · 20 行 · 源文件 blocks/FB_Replace_Demo.scl

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

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

SCL 写法

SCL
1#Result := REPLACE(IN1 := #Text, IN2 := #NewText, L := #Count, P := #Pos);

典型用法：先 FIND 定位，再替换：

SCL
1#Pos := FIND(IN1 := #Text, IN2 := 'old');
2IF #Pos > 0 THEN
3   #Result := REPLACE(IN1 := #Text, IN2 := 'new', L := 3, P := #Pos);
4END_IF;

怎么工作

条件 结果
P=3, L=2 第 3、4 个字符被替换
L=0 不替换，插入到 P 之后
P>LEN 追加到末尾
P≤0 空串
L<0 空串
L 超过剩余长度 从 P 替换到末尾
  • P 是 1-based：第一个字符是 1。
  • L 是“替换几个字符”，不是结束位置。
  • 新字符串比旧字符串长时结果变长，短时结果变短；目标 STRING[n] 容量要够。
  • L=0 的行为和 INSERT 一致，可用于“只插入不删除”。

常用场景

1. 替换固定位置的字段

协议里某个字段位置固定，用 REPLACE 替换；如果位置不固定，先用 FIND 定位。

2. 替换分隔符/关键字

把 ; 替换成 ,，或把旧设备名替换成新设备名；循环替换全部出现的位置时，要自己控制下一次起始位置。

3. 替换为更长/更短的文本

日志脱敏、单位替换等；注意目标字符串容量和截断规则。

常见坑

  • 把 P 当 0-based：第一个字符是 1；P=0 返回空串。
  • L 当结束位置：L 是替换长度，不是“替换到第几个”。
  • L=0 以为不操作：L=0 会插入新字符串，不是无操作；无操作要直接跳过调用。
  • P 越界：会追加到末尾，不会报错；要严格控制时先 LEN。
  • 新字符串更长：结果可能被目标容量截断；先算好 STRING[n]。
  • 只替换一次：REPLACE 只处理指定位置；全文替换要循环并更新查找起点。

和 LAD 的区别

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

云仿真验证

PLC 云仿真：PASS（4 次扫描）。场景：替换 2 个字符、L=0 插入、越界追加。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  替换 2 个字符、L=0 插入、越界追加 (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/REPLACE__Replace_characters_in_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

REPLACE 和 INSERT 有什么区别？

INSERT 只插入、不删除；REPLACE 会先用新字符串替换掉 L 个旧字符。L=0 时 REPLACE 的行为接近 INSERT。

L=0 会删除什么？

不删除，直接把新字符串插入到 P 位置之后；和 INSERT 的规则一致。

新字符串比旧字符串长会怎样？

结果会变长；目标 `STRING[n]` 的 n 要足够大，否则会被截断。新字符串更短时结果会变短。

← 返回 SCL 指令手册