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

SCL UPPER_BOUND — 数组上界

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

数组与DB S7-1200/1500 TIA V19 别名:数组上界 / UPPER_BOUND

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

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

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

参数

参数方向类型存储区说明
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_UpperBound_Demo FB

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

查看 FB_UpperBound_Demo 的块接口
区块名称类型说明
输出HighDInt
输出LowDInt
输出CountDInt
输入/输出DataARRAY[*] OF Int
blocks/FB_UpperBound_Demo.scl
1FUNCTION_BLOCK "FB_UpperBound_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      High : DInt;               // 上界
10      Low : DInt;                // 下界
11      Count : DInt;              // 元素个数
12   END_VAR
13 
14BEGIN
15   REGION 读取数组边界
16      #High := UPPER_BOUND(ARR := #Data, DIM := 1);
17      #Low := LOWER_BOUND(ARR := #Data, DIM := 1);
18      #Count := #High - #Low + 1;
19   END_REGION
20END_FUNCTION_BLOCK
21 

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

SCL 写法

SCL
1#High := UPPER_BOUND(ARR := #Data, DIM := 1);
2#Low := LOWER_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[*]) UPPER_BOUND(..., DIM=1)
Array[0..7] 7
Array[1..8] 8
Array[-2..2] 2
Array[*] 运行时上界
  • DIM 是维度号,从 1 开始;一维数组写 1。
  • 返回类型是 DINT;元素个数用 UPPER_BOUND - LOWER_BOUND + 1。
  • 结果是调用时绑定数组的实际上界;ARRAY[*] 让同一个块适配不同长度的数组。
  • 上界不一定是长度;Array[1..8] 的上界是 8,但下界不是 0。

常用场景

1. 通用数组遍历

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;分别读取上下界。

常见坑

  • 把上界当长度:Array[1..8] 上界是 8,长度也是 8;Array[0..7] 上界是 7,长度是 8。用 Upper - Lower + 1 算长度。
  • 假设下界是 0:下界用 LOWER_BOUND,别写死 0。
  • DIM 从 0 开始:DIM 从 1 开始;0 不是合法维度。
  • 用标量:ARR 必须是数组;标量编译报错。
  • ARRAY[*] 未绑定:运行时没有实际数组时结果无效;先确保调用方传了数组。
  • CPU 固件:S7-1200 需 FW ≥ 4.2,S7-1500 需 FW ≥ 2.0;老固件不支持。

和 LAD 的区别

LAD 的 UPPER_BOUND 是带 ARR/DIM 的盒;SCL 里直接写函数调用,可以放在 FOR 边界表达式里。语义一样,SCL 更适合写通用数组库。梯形图版本见 Learn-LAD 的 Upper_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[_]/UPPER_BOUND__Read_out_high_ARRAY_limit.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

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

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

常见问题

UPPER_BOUND 的 DIM 从 0 还是 1 开始?

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

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

分别返回 7 和 8,按数组声明上界返回。

元素个数怎么算?

`UPPER_BOUND - LOWER_BOUND + 1`;不要只取上界当长度。

← 返回 SCL 指令手册