跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL SHL — 左移

SCL SHL — 左移

左移,低位补 0。

移位 S7-1200/1500 TIA V19 别名:左移 / SHL

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案:#Result := SHL(IN := #Value, N := #Count) 把位串左移 N 位,低位补 0;N≥位宽时结果为 0。

SHL 把位串左移 N 位,低位补 0:#Result := SHL(IN := #Value, N := #Count);。N=0 返回原值,N≥位宽 结果为 0。

参数

参数方向类型存储区说明
IN输入BYTE / WORD / DWORD / LWORDI, Q, M, D, L, P要左移的位串。
N输入整数I, Q, M, D, L, P左移位数,必须 ≥0;N=0 返回原值,N≥位宽时结果为 0。
Return返回值与 IN 相同的位串类型—左移结果;低位补 0。

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

最小示例

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

FB_Shl_Demo FB

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

查看 FB_Shl_Demo 的块接口
区块名称类型说明
输入ValueWord
输入NUInt
输出ResultWord
blocks/FB_Shl_Demo.scl
1FUNCTION_BLOCK "FB_Shl_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Value : Word := 16#0001;  // 位串
6      N : UInt := 1;            // 左移位数
7   END_VAR
8 
9   VAR_OUTPUT
10      Result : Word;           // 左移结果
11   END_VAR
12 
13BEGIN
14   REGION 左移
15      #Result := SHL(IN := #Value, N := #N);
16   END_REGION
17END_FUNCTION_BLOCK
18 

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

SCL 写法

SCL
1#Result := SHL(IN := #Value, N := #Count);

SHL 是函数调用,结果直接赋给位串变量;它不修改输入。IN 的类型决定位宽,N 是移位数。

怎么工作

IN(Word) N 结果
16#0001 1 16#0002
16#8000 1 16#0000
16#0001 0 16#0001
16#0001 16 16#0000
  • 支持 BYTE/WORD/DWORD/LWORD;位宽由 IN 类型决定。
  • 左移低位补 0;移出的高位丢弃。
  • N 必须 ≥0;N=0 不变,N≥位宽 全移出为 0。
  • 是逻辑移位,不是循环移位;循环左移用 ROL。

常用场景

1. 位掩码生成

SHL(IN := 1, N := #BitNo) 生成某一位的掩码;比 DECO 更直接(位宽内)。

2. 通信字打包

把多个位/字段左移到目标位置,再 OR 成一个字。

3. 定点数缩放

无符号整数左移实现乘以 2 的幂;注意溢出位会丢。

常见坑

  • N 超过位宽:结果为 0,不是循环;要循环用 ROL。
  • 用 Int/Real:SHL 只接受位串;先转 WORD/DWORD。
  • 当成有符号乘法:左移会丢溢出位,负数/符号位要单独处理。
  • N 为负:非法;先检查。
  • 位宽选错:Byte 移 8 位就全 0;用 Word/DWord 需要更大范围。
  • 和 ROL 混用:SHL 补 0,ROL 把移出的位补回低位。

和 LAD 的区别

LAD 的 SHL 是带 IN/N 的盒;SCL 里直接写函数调用,可以嵌在表达式里。语义一样,SCL 更容易把移位和掩码逻辑连写。梯形图版本见 Learn-LAD 的 Shl 页。

云仿真验证

PLC 云仿真:PASS(4 次扫描)。场景:左移 1 位、最高位移出、N=0、N=16。结果来自 PLC 云仿真 的 scl_run_scenario。

查看云仿真回归输出
云仿真回归输出
PASS  左移 1 位、最高位移出、N=0、N=16 (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 导入编译PASS(0 error / 0 warning)2026-11-02TiaLink + TIA Portal

“待实测”表示还没有在 TIA Portal 里导入编译,不代表代码有问题;上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行,不替代 TIA 编译。

来源与说明

参数、行为和数据类型的核对来源:TIA Portal V19 帮助的 Instructions/Instructions/Basic_instructions/SCL/Shift_and_Rotate/SHR__Shift_right.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

SHL 的专用帮助页在抓取语料中损坏;左移、补 0、N=0/N≥位宽规则以 TIA V19 相邻移位指令页和实际编译为准。中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

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

常见问题

SHL 支持哪些类型?

BYTE、WORD、DWORD、LWORD;不能用 Int/Real,位宽由 IN 的类型决定。

N 大于位宽会怎样?

所有位都移出,结果为 0;要循环移位用 ROL。

SHL 和乘以 2 的关系?

左移 1 位相当于无符号乘以 2;溢出位丢弃,不会自动限幅。

← 返回 SCL 指令手册