跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL CONCAT — 拼接字符串

SCL CONCAT — 拼接字符串

把多个 STRING/WSTRING 拼成一个；注意目标长度和参数个数。

字符串 S7-1200/1500 TIA V19 别名：Combine character strings / 字符串拼接 / CONCAT / STRING

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案：用 #Result := CONCAT(IN1 := #A, IN2 := #B) 拼接字符串；结果超过目标长度会被截断，拼接前先算好总长度。

CONCAT 把多个 STRING/WSTRING 拼成一个：#Result := CONCAT(IN1 := #A, IN2 := #B);。结果超过目标字符串最大长度时会被截断，拼接前先算好总长度。

参数

参数方向类型存储区说明
IN1...INn输入STRING / WSTRINGD, L, P要拼接的字符串。SCL 最多 32 个输入，编号 IN1..IN32 必须连续；最少 2 个。
Return返回值STRING / WSTRING—拼接结果。结果超过目标字符串最大长度时会被截断或报错，取决于指令/版本。

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

最小示例

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

FB_Concat_Demo FB

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

查看 FB_Concat_Demo 的块接口
区块名称类型说明
输入ASTRING
输入BSTRING
输出ResultSTRING
blocks/FB_Concat_Demo.scl
1FUNCTION_BLOCK "FB_Concat_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      A : String;                // 前半段
6      B : String;                // 后半段
7   END_VAR
8 
9   VAR_OUTPUT
10      Result : String;           // 拼接结果
11   END_VAR
12 
13BEGIN
14   REGION 拼接字符串
15      #Result := CONCAT(IN1 := #A, IN2 := #B);
16   END_REGION
17END_FUNCTION_BLOCK
18

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

SCL 写法

SCL
1#Result := CONCAT(IN1 := #A, IN2 := #B);

拼接前缀、名称、后缀：

SCL
1#Message := CONCAT(IN1 := 'Tank ', IN2 := #TankName, IN3 := ' empty');

怎么工作

  • IN1...INn 按顺序拼接；SCL 最多 32 个输入，编号 IN1..IN32 必须连续。
  • 返回值是拼接后的字符串；通常赋给 STRING[n] 或 WSTRING[n]。
  • 结果长度超过目标最大长度时，可能截断或报错；用 LEN 先算长度。
  • 空字符串参与拼接不会改变结果。
输入 输出
'Tank' + '-01' 'Tank-01'
'' + 'X' 'X'
'A' + '' 'A'

常用场景

1. 设备名/消息拼接

把设备前缀、编号、状态拼成 HMI 消息：'Pump ' + '03' + ' fault'。注意消息长度和字符集。

2. 配方/文件名字符串

RecipeExport/DataLog 的文件名、路径常用 CONCAT 拼接；路径分隔符和最大长度要提前算好。

3. 报警文本

把报警代码、设备名、处理建议拼成一条文本；如果文本很长，考虑用 WSTRING 或分段显示。

常见坑

  • 目标长度不够：STRING[20] 只能放 20 个字符；拼接前用 LEN 算总长度，或者把目标声明大一点。
  • STRING 和 WSTRING 混用：类型不一致会编译报错或乱码；统一用同一种字符串类型。
  • 参数编号不连续：SCL 的扩展输入必须 IN1..INn 连续编号；跳号会编译报错。最多 32 个输入。
  • 中文/特殊字符：STRING 按字节，中文可能占多个字节；需要中文时用 WSTRING 或确认编码。
  • 空字符串：空串不会报错，但会让结果少一段；调试时检查输入是否为空。
  • 不是数组拼接：CONCAT 拼的是字符串，不是数组；数组合并用 MOVE_BLK 或循环。

和 LAD 的区别

LAD 里 CONCAT 是带 IN1/IN2/OUT 的盒；SCL 里是函数调用，结果可以直接赋给变量或继续嵌套。字符串操作在 SCL 里更自然，但长度和类型规则完全一样。梯形图版本见 Learn-LAD 的 CONCAT 页。

云仿真验证

PLC 云仿真：PASS（2 次扫描）。场景：拼接两个字符串。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  拼接两个字符串 (2 step(s), 2 scan(s))
RESULT: ALL PASS (2 scan(s))

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

验证状态

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

参数和字符串长度规则以 TIA Portal V19 帮助为事实核对；中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

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

常见问题

CONCAT 可以拼几个字符串？

SCL 最多 32 个输入（IN1..IN32，编号必须连续）；常见是 2 个，要拼更多就用 IN3、IN4……，也可以嵌套 CONCAT。

拼接结果太长会怎样？

结果超过目标字符串的最大长度时会被截断或报错，取决于指令和版本；拼接前先用 LEN 算总长度，确保目标 STRING[n] 的 n 够用。

STRING 和 WSTRING 能混用吗？

不要混用。STRING 是单字节字符，WSTRING 是宽字符；混用需要显式转换，否则编译报错或出现乱码。

← 返回 SCL 指令手册