跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL FIND — 查找子串

SCL FIND — 查找子串

查找子串位置；找不到返回 0。

字符串 S7-1200/1500 TIA V19 别名：查找子串 / FIND

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案：#Position := FIND(IN1 := #Text, IN2 := #Search) 返回子串第一次出现的位置（从 1 开始）；找不到返回 0。

FIND 返回子串在字符串中第一次出现的位置：#Position := FIND(IN1 := #Text, IN2 := #Search);。位置从 1 开始；找不到返回 0。

参数

参数方向类型存储区说明
IN1输入STRING / WSTRINGD, L, P 或常量被搜索的字符串。
IN2输入STRING / WSTRINGD, L, P 或常量要查找的子串。空串返回 0。
Return返回值INT—子串第一次出现的位置，第一个字符是 1；找不到返回 0。

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

最小示例

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

FB_Find_Demo FB

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

查看 FB_Find_Demo 的块接口
区块名称类型说明
输入TextSTRING
输入SearchSTRING
输出PositionInt
输出FoundBool
blocks/FB_Find_Demo.scl
1FUNCTION_BLOCK "FB_Find_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Text : String;          // 被搜索的字符串
6      Search : String;        // 要查找的子串
7   END_VAR
8 
9   VAR_OUTPUT
10      Position : Int;         // 第一次出现的位置，找不到为 0
11      Found : Bool;           // Position > 0
12   END_VAR
13 
14BEGIN
15   REGION 查找子串
16      #Position := FIND(IN1 := #Text, IN2 := #Search);
17      #Found := #Position > 0;
18   END_REGION
19END_FUNCTION_BLOCK
20

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

SCL 写法

SCL
1#Position := FIND(IN1 := #Text, IN2 := #Search);
2#Found := #Position > 0;

典型用法：先找分隔符，再用 MID 取字段：

SCL
1#Dash := FIND(IN1 := #OrderNo, IN2 := '-');
2IF #Dash > 0 THEN
3   #Prefix := LEFT(IN := #OrderNo, L := #Dash - 1);
4   #Suffix := MID(IN := #OrderNo, L := 2, P := #Dash + 1);
5END_IF;

怎么工作

输入 返回
'Tank-01' 找 '-' 5
'Tank-01' 找 'Tank' 1
'Tank-01' 找 'XYZ' 0
搜索空串 0
源串为空 0
  • 位置是 1-based：第一个字符的位置是 1。
  • 只返回第一次出现的位置；要找下一次，需要从 Position + 1 开始截取后再查。
  • 区分大小写：'Tank' 和 'tank' 不同。
  • 找不到返回 0，所以用 Position > 0 判断是否找到。

常用场景

1. 按分隔符拆字段

CSV 或 键=值 文本，先 FIND 找 ,、;、=，再用 LEFT/MID 取前后字段。

2. 判断前缀/后缀

FIND(IN1 := #Text, IN2 := 'ERR') = 1 表示以 ERR 开头；判断后缀要先算位置：Position = LEN(IN1) - LEN(IN2) + 1。

3. 校验消息格式

消息里必须包含 ACK；FIND 返回 0 就丢弃或报警。比逐个字符比较简单。

常见坑

  • 用 0 当第一个字符：位置从 1 开始；0 是“没找到”，不是第一个字符。
  • 忽略大小写：FIND 区分大小写；需要忽略时先统一大小写。
  • 只找一次：要统计出现次数或找第二个，必须循环截取，不能只调一次。
  • 空搜索串：返回 0；不要把它当成“找到开头”。
  • 多字节字符：STRING 按单字节，中文可能占多个字节；宽字符用 WSTRING。
  • 用 FIND 做全文替换：FIND 只定位，不修改字符串；替换用 REPLACE。

和 LAD 的区别

LAD 的 FIND 盒有 IN1、IN2 和返回值；SCL 里直接写 FIND(IN1 := ..., IN2 := ...)，可以放在 IF 条件里。语义一样，SCL 更适合把查找和截取写成连续表达式。梯形图版本见 Learn-LAD 的 FIND 页。

云仿真验证

PLC 云仿真：PASS（5 次扫描）。场景：找到、未找到和空串。结果来自 PLC 云仿真 的 scl_run_scenario；页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  找到、未找到和空串 (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/FIND__Find_characters_in_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

FIND 找不到为什么返回 0？

TIA 的约定是找不到返回 0。0 不是合法字符位置，所以可以用 `IF Position > 0` 判断是否找到。

FIND 区分大小写吗？

区分。`'Tank'` 和 `'tank'` 是不同的字符串；需要忽略大小写时先统一转成大写或小写（如果版本支持）。

空字符串会返回什么？

搜索空串返回 0；空源串也返回 0。解析前先判断两个输入是否为空。

← 返回 SCL 指令手册