跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL LOWER_BOUND — 数组下界

SCL LOWER_BOUND — 数组下界

读数组下界;配合 VARIANT/ARRAY[*] 使用。

数组与DB S7-1200/1500 TIA V19 别名:数组下界 / LOWER_BOUND

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

答案:#Low := LOWER_BOUND(ARR := #Data, DIM := 1) 读一维数组的下界;DIM 从 1 开始,返回值是 DINT。

LOWER_BOUND 读数组某一维的下界:#Low := LOWER_BOUND(ARR := #Data, DIM := 1);。DIM 从 1 开始,返回值是 DINT;Array[0..7] 返回 0,Array[1..8] 返回 1。

参数

参数方向类型存储区说明
ARR输入/输出ARRAY[*]—要查询下界的数组。FB 里用 InOut,FC 里可用 Input/InOut;不能传普通标量。
DIM输入UDINTI, Q, M, D, L, P 或常量数组维度,从 1 开始;一维数组写 1。
Return返回值DINT—该维度的下界。固定 ARRAY 返回声明下界,ARRAY[*] 返回运行时下界。

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

最小示例

下面是一个完整块,页面展示的源码就是 TiaLink 导入的同一份源码。页面代码已通过构建期语法/结构校验;云仿真状态见下方。

FB_LowerBound_Demo FB

最小示例 · 21 行 · 源文件 blocks/FB_LowerBound_Demo.scl

查看 FB_LowerBound_Demo 的块接口
区块名称类型说明
输出LowDInt
输出HighDInt
输出CountDInt
输入/输出DataARRAY[*] OF Int
blocks/FB_LowerBound_Demo.scl
1FUNCTION_BLOCK "FB_LowerBound_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_IN_OUT
5      Data : Array[*] of Int;    // 通用数组:调用方绑定实际数组
6   END_VAR
7 
8   VAR_OUTPUT
9      Low : DInt;                // 下界
10      High : DInt;               // 上界
11      Count : DInt;              // 元素个数
12   END_VAR
13 
14BEGIN
15   REGION 读取数组边界
16      #Low := LOWER_BOUND(ARR := #Data, DIM := 1);
17      #High := UPPER_BOUND(ARR := #Data, DIM := 1);
18      #Count := #High - #Low + 1;
19   END_REGION
20END_FUNCTION_BLOCK
21 

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

SCL 写法

SCL
1#Low := LOWER_BOUND(ARR := #Data, DIM := 1);
2#High := UPPER_BOUND(ARR := #Data, DIM := 1);
3#Count := #High - #Low + 1;

ARR 必须是 ARRAY[*](变量边界数组):示例块用 Data : Array[*] of Int 做通用库,调用方传 Array[1..8] 等实际数组。TIA 会拒绝把固定 Array[1..8] 直接当 ARR,报“Only ARRAYs with variable limits are permitted”。

怎么工作

调用方实际数组(绑定到 Array[*]) LOWER_BOUND(..., DIM=1)
Array[0..7] 0
Array[1..8] 1
Array[-2..2] -2
Array[*] 运行时下界
  • DIM 是维度号,从 1 开始;一维数组写 1。
  • 返回类型是 DINT;元素个数用 UPPER_BOUND - LOWER_BOUND + 1。
  • 结果是调用时绑定数组的实际下界;ARRAY[*] 让同一个块适配不同长度的数组。
  • 不要假设下界一定是 0;数组可以从 1、负数或任意值开始。

常用场景

1. 通用数组遍历

写库函数时不知道调用方数组从 0 还是 1 开始;用 LOWER_BOUND/UPPER_BOUND 动态取范围:

SCL
1FOR #i := LOWER_BOUND(ARR := #Data, DIM := 1) TO UPPER_BOUND(ARR := #Data, DIM := 1) DO
2   // ...
3END_FOR;

2. 校验数组长度

Count := Upper - Lower + 1;和期望长度比较,避免调用方传错数组。

3. 多维数组

二维数组第一维 DIM=1,第二维 DIM=2;分别读取。

常见坑

  • 假设下界是 0:Array[1..8] 的下界是 1;写死 0 会漏掉第一个元素或越界。
  • DIM 从 0 开始:DIM 从 1 开始;0 不是合法维度。
  • 用标量:ARR 必须是数组;标量编译报错。
  • 和 UPPER_BOUND 混用:下界用 LOWER_BOUND,上界用 UPPER_BOUND。
  • ARRAY[*] 未绑定:运行时没有实际数组时结果无效;先确保调用方传了数组。
  • CPU 固件:S7-1200 需 FW ≥ 4.2,S7-1500 需 FW ≥ 2.0;老固件不支持。

和 LAD 的区别

LAD 的 LOWER_BOUND 是带 ARR/DIM 的盒;SCL 里直接写函数调用,可以放在 FOR 边界表达式里。语义一样,SCL 更适合写通用数组库。梯形图版本见 Learn-LAD 的 Lower_Bound 页。

云仿真验证

本页代码已通过构建期语法/结构校验。该示例使用 Array[*],需要调用方绑定实际数组;云仿真只做 scl_validate,未跑场景。 云仿真校验日期:2026-11-02。

打开 PLC 云仿真

验证状态

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

ARR/DIM 参数、1-based 维度和 DINT 返回值以 TIA Portal V19 帮助为事实核对;中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

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

常见问题

LOWER_BOUND 的 DIM 从 0 还是 1 开始?

从 1 开始。一维数组写 DIM=1;二维数组的第一维是 1,第二维是 2。

Array[0..7] 和 Array[1..8] 返回什么?

分别返回 0 和 1,按数组声明下界返回,不是固定返回 0。

为什么不能用普通变量?

ARR 需要 ARRAY 类型;标量没有维度信息,编译会报错。

← 返回 SCL 指令手册