跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL RIGHT — 取右字符串

SCL RIGHT — 取右字符串

取右边 N 个字符。

字符串 S7-1200/1500 TIA V19 别名:右字符串 / RIGHT

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案:#Result := RIGHT(IN := #Text, L := #Count) 从右边取 L 个字符;L≤0 返回空串,L 超过长度返回整个字符串。

RIGHT 从字符串右边取 L 个字符:#Result := RIGHT(IN := #Text, L := #Count);。L 是字符个数,不是起始位置;L≤0 返回空串,L 超过长度返回整个字符串。

参数

参数方向类型存储区说明
IN输入STRING / WSTRINGD, L, P 或常量源字符串。
L输入BYTE / INT / SINT / USINTI, Q, M, D, L 或常量从右边取多少个字符。L ≤ 0 返回空串;L 大于字符串长度时返回整个字符串。
Return返回值STRING / WSTRING—取出的右边子串。

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

最小示例

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

FB_Right_Demo FB

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

查看 FB_Right_Demo 的块接口
区块名称类型说明
输入TextSTRING
输入CountInt
输出ResultSTRING
blocks/FB_Right_Demo.scl
1FUNCTION_BLOCK "FB_Right_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Text : String;          // 源字符串
6      Count : Int := 2;       // 从右边取几个字符
7   END_VAR
8 
9   VAR_OUTPUT
10      Result : String;        // 右边子串
11   END_VAR
12 
13BEGIN
14   REGION 取右边字符
15      #Result := RIGHT(IN := #Text, L := #Count);
16   END_REGION
17END_FUNCTION_BLOCK
18 

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

SCL 写法

SCL
1#Result := RIGHT(IN := #Text, L := #Count);

常见用法是取后缀/扩展名:

SCL
1#Suffix := RIGHT(IN := #FileName, L := 3);  // 'report.csv' -> 'csv'

怎么工作

L 结果
≤ 0 空串 ''
1 最后一个字符
小于长度 右边 L 个字符
≥ 长度 整个字符串
空输入 空串
  • L 是“取几个字符”,不是“从第几个开始”。
  • 结果长度不会超过 L,也不会超过源字符串长度。
  • 目标字符串容量不够时,结果会被截断到目标容量;声明 String 时默认容量 254。
  • STRING/WSTRING 都支持;中文宽字符用 WSTRING。

常用场景

1. 取文件扩展名

文件名 report.csv 取最后 3 个字符得到 csv;如果要按最后一个点分割,先 FIND 找点,再用 MID 更稳。

2. 取编号后缀

设备编号 PUMP-001 取最后 3 位得到 001;用于分组或显示。

3. 截断显示尾部

日志消息只显示最后 20 个字符,前面用省略号;先 LEN 判断是否需要截断,再 RIGHT。

常见坑

  • 把 L 当起始位置:RIGHT 没有起始位置参数;按位置取用 MID。
  • L=0 返回空串:协议里空串可能被当成“无数据”,先判断再使用。
  • L 超过长度:返回整串,不会补空格。
  • 目标容量不够:结果会被截断;先算好目标 STRING[n] 的 n。
  • 中文按字节误解:STRING 是单字节字符,中文可能占多个字节;宽字符用 WSTRING。
  • 空输入:返回空串,不报错;业务上要区分“空”和“解析失败”。

和 LAD 的区别

LAD 的 RIGHT 盒有 IN、L 和返回值;SCL 里直接写 RIGHT(IN := ..., L := ...),可以嵌在表达式里。语义一样,SCL 更容易和 FIND、MID 组合做解析。梯形图版本见 Learn-LAD 的 RIGHT 页。

云仿真验证

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

查看云仿真回归输出
云仿真回归输出
PASS  取最后 2 个字符,边界情况 (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/RIGHT__Read_the_right_characters_of_a_character_string.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

RIGHT 的 L 是从右边数第几个吗?

不是,L 是“取几个字符”。L=2 取最后两个字符;要按位置取从左边数第 N 个开始的子串,用 MID。

L 大于字符串长度会怎样?

返回整个字符串,不会补空格,也不会报错。

空字符串会怎样?

返回空串。先判断源字符串是否为空,避免把空结果当有效数据。

← 返回 SCL 指令手册