Engee 文档

对于迭代器

for-iterator 子系统的控制单元。

类型: ForIterator

图书馆中的路径:

/Basic/Ports & Subsystems/For Iterator

说明

置于*子系统*块中的*对于迭代器*块在当前时间步长内重复执行子系统,直到迭代变量超过指定的迭代限制。您可以使用该程序块来实现流程图,相当于编程语言中的*for*循环。

迭代子系统*块的输出不能是函数调用信号。更新模型时,Engee 会显示错误信息。

端口

输入

N - 外部迭代限制值
标量

用于连接外部迭代次数限制源的输入端口。端口上的值用作循环的最大迭代次数。 输入端口接受混合数值类型的数据。

依赖关系

要使用此端口,请将*迭代限制源*参数设置为 "外部"。

数据类型: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Next_i - 迭代变量的外部值
标量

用于连接迭代变量外部源的输入端口。当前迭代的输入值将作为下一次迭代的迭代变量值。 输入端口接受混合数值类型的数据。

依赖关系

要使用该端口,请选择 从外部设置下一个 i(迭代变量) 复选框。

数据类型: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

输出

1:N-迭代变量在该步骤中的值
标量

步骤中迭代变量的值。

依赖关系

要使用此端口,请选择 显示迭代变量 复选框。

数据类型: Int8, Int16, Int32, Float64

参数

迭代限制源-迭代次数的来源
内部(默认) | `外部

选择迭代次数的来源。

内部"--*迭代限制*参数的值决定迭代次数。

外部"- *N*端口上的信号值决定迭代次数。

依赖关系

选择 "内部 "会显示并启用*迭代限制*参数。选择 "外部 "会增加一个标有 N 的输入端口。

软件使用

块参数

IterationSource

价值观

internal | external

默认值

internal

迭代限制 - 指定迭代次数
5(默认值)` | `一个整数

指定迭代次数。此参数支持存储类。 5 - 在 For Iterator Subsystem 块中重复块 5 次。

` integer` - 指定一个整数或一个已命名的常量变量。

依赖关系

要使用此参数,请在*迭代限制源*参数中选择 "内部"。

软件使用

块参数

IterationLimit

价值观

5 | <integer>

默认值

5

从外部设置下一个 i(迭代变量) - 输入端口显示控制
已禁用(默认) | 已启用

控制输入端口显示。 disabled - 不显示输入端口。 on - 显示带有 Next_i 标记的输入端口,以连接外部迭代变量源。当前迭代的输入值将作为下一次迭代的迭代变量值。

依赖关系

要使用该参数,请选中*显示迭代变量*复选框,同时显示标有 *1:N*的输出端口。

软件使用

块参数

ExternalIncrement

价值观

|

默认值

显示迭代变量 - 控制输出端口的显示
已启用(默认) | 已禁用

控制输出端口的显示。 disabled - 不显示输出端口。 enabled - 用 1:N 显示输出端口。

依赖关系

要使用该参数,请勾选 从外部设置下一个 i(迭代变量) 复选框。

软件使用

块参数

ShowIterationPort

价值观

|

默认值

索引模式 - 指定初始迭代次数
基于一(默认)` | 基于零

指定索引模式为 "基于零 "或 "基于一"。

对于 "基于零 "的索引,索引 0 指定输入向量的第一个元素。索引 1 表示第二个元素,以此类推。

对于 One-based 索引,索引 1 指定输入向量的第一个元素。索引 2 指定第二个元素,以此类推。

程序使用

块参数

IndexMode

价值观

Zero-based |One-based

默认值

One-based

迭代变量数据类型 - 输出数据类型
Int32(默认) | Int16 | Int8 | `Float64

设置从迭代次数端口输出迭代值的数据类型。

软件使用

块参数

IterationVariableDataType

价值观

Int32 | Int16 | Int8 | Float64

默认值

Int32

附加选项

C 代码生成: 是