If

使用类似于 if-else 语句的逻辑选择子系统执行

全页展开

库:
Simulink / Ports & Subsystems

描述

If 模块以及包含 Action Port 模块的 If Action Subsystem 模块实现 if-else 逻辑来控制子系统的执行。有关使用 If 模块的示例，请参阅选择子系统执行。

Model ex_if_block

示例

Simulink 子系统语义

这组示例说明不同类型的 Simulink® 子系统，以及对这些子系统进行仿真时使用的语义。每个示例都提供了对模型的描述以及控制模型执行方式的诀窍。

打开实时脚本

If-Then-Else 模块

此示例说明将正弦波馈入 If Action Subsystem 模块的效果。它旨在说明 If Action Subsystem 模块和 Enabled Subsystem 模块之间的相似性。

打开模型

Modeling Clutch Lock-Up Using If Blocks

Use If/Else subsystems to build a clutch model. An 'If' subsystem models the clutch dynamics in the locked position while an 'Else' subsystem models the unlocked position. One or the other is enabled using the 'If' block. The dot-dashed lines from the 'If' block denote control signals, which are used to enable If/Else (or other conditional) subsystems. Checking any of the boxes on the GUI produces a plot of any of the selected variables (versus time).

打开模型

限制

If 模块具有以下限制：

它不支持可调参数。在普通模式或加速模式下的仿真过程中，或在运行生成的代码时，不能调整 if 或 elseif 表达式的值。
要实现可调整的 if-else 表达式，请在 If 模块外部调整表达式。例如，使用 Relational Operator 模块计算 If 模块外部的外部表达式或将可调参数作为输入添加到 If 模块。
它不支持自定义存储类。请参阅使用 Struct 存储类将参数数据组织为结构体 (Embedded Coder)。
If 表达式和 elseif 表达式不能接受某些运算符，如 +、-、* 和 /。

端口

输入

全部展开

Logical operands — 用于计算逻辑表达式的值
标量 | 向量

输入 u1,u2,...,un 必须具有相同的数据类型。输入不能是任何用户定义的类型，例如枚举类型。

If 模块不直接支持定点数据类型。但是，可以使用 Compare To Constant 模块解决此限制。请参阅选择子系统执行中对定点数据类型的支持。

输出

全部展开

Action — 用于 If Action Subsystem 模块的动作信号
标量

来自 if、else 和 elseif 端口的输出是到 If Action Subsystem 模块的动作信号。

参数

全部展开

输入数目 — 指定输入端口个数
`1` (默认) | 整数

1: 指定一个输入端口。
整数: 指定输入端口个数。模块端口的标签为 'u' 字符后跟数字 1,2,...,n，其中 n 等于您指定的输入数目。

编程用法

模块参数：NumInputs

类型：字符向量

值：'1' | 用引号引起来的整数

默认值：'1'

显示 else 条件 — 控制 else 端口的显示
`on` (默认) | `off`

当 if 端口和所有 elseif 端口表达式为 false 时，else 端口发送动作信号来执行所连接的 If Action Subsystem 模块。

on: 显示 else 端口。
off: 隐藏 else 端口。

编程用法

模块参数：ShowElse

类型：字符向量

值：'on' | 'off'

默认值：'on'

启用过零检测 — 控制过零检测
`on` (默认) | `off`

控制过零检测。

on: 检测过零点。
off: 不检测过零点。

编程用法

模块参数：ZeroCross

类型：字符向量

值：'on' | 'off'

默认值：'on'

在生成的代码中提供 if-else 语句 — 在从 If 模块生成的代码中仅包含 if-else 语句的选项
`off` (默认) | `on`

自 R2025a 起

选择此参数可确保从 If 模块生成的代码中仅包含 if-else 语句。

on: 在生成的代码中仅包含 if-else 语句。此选项可防止在生成的代码中包含 switch-case 语句。
off: 当此参数为 off 时，从 If 模块生成的代码可能包含 switch-case 语句（这些语句执行与 If 模块相同的操作）。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

模块参数：EnsureIfElseCode

类型：字符向量

值：'on' | 'off'

默认值：'off'

if — 逻辑表达式
`u1 > 0` (默认) | 逻辑表达式

连接到 if 端口的 If Action Subsystem 模块在关联的 if 表达式的计算结果为 true 时执行。

u1 > 0

指定当输入 u1 大于 0 时在输出端口上发送动作信号。

逻辑表达式

注意

从 R2025a 开始，要编辑默认 if 表达式 (u1 > 0)，请使用表达式表。对于包含多个输入和运算符的复杂表达式，请选择 if 表达式并在表达式编辑器框中编辑。

对于 R2025a 之前的版本，此参数在模块对话框中显示为 If 表达式。您可以使用此参数指定逻辑表达式。

不过，对于所有 Simulink^® 版本，此表达式在 If 模块上与 if 输出端口相邻显示。

该表达式只能包含运算符 <, <=, ==, ~=, >, >=, &, |, ~, () 和 unary-minus。不允许使用 +, -, *, / 和 ^ 等运算符。该表达式不能包含数据类型表达式（例如 int8(6)），并且不能引用任何数据类型不是 double 或 single 的工作区变量。

编程用法

模块参数：IfExpression

类型：字符向量

值：'u1 > 0' | 用引号引起来的逻辑表达式

默认值：'u1 > 0'

elseif — 逻辑表达式
空 (默认) | 逻辑表达式列表

连接到 elseif 端口的 If Action Subsystem 模块在关联的 elseif 表达式计算结果为 true 且所有其他 if 和 elseif 表达式为 false 时执行。

空

未指定逻辑表达式。

逻辑表达式列表

注意

从 R2025a 开始，要添加和编辑 elseif 表达式，请使用表达式表。使用表左侧的操作按钮添加、删除和移动表达式。该表允许您分别编写每个 elseif 表达式，而不是在以逗号分隔的列表中编写，并可根据建模需求组织表达式。对于包含多个输入和运算符的复杂表达式，请选择包含该 elseif 表达式的行并在表达式编辑器框中编辑它。

对于 R2025a 之前的版本，此参数在模块对话框中显示为 Else 表达式。在这些版本中，指定以逗号分隔的逻辑表达式列表。

不过，对于所有 Simulink 版本，当您选中显示 else 条件复选框时，表达式出现在 If 模块上的 if 端口下方及 else 端口上方。

表达式只能包含运算符 <, <=, ==, ~=, >, >=, &, |, ~, () 和 unary-minus。不允许使用 +, -, *, / 和 ^ 等运算符。表达式不能包含数据类型表达式（例如 int8(6)），并且不能引用任何数据类型不是 double 或 single 的工作区变量。

编程用法

模块参数：ElseIfExpressions

类型：字符向量

值：'' | 用引号引起来的以逗号分隔的逻辑表达式列表

默认值：''

模块特性

数据类型	`Boolean` \| `double` \| `integer` \| `single`
直接馈通	`是`
多维信号	`否`
可变大小信号	`否`
过零检测	`是`

扩展功能

全部展开

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

HDL Coder™ 提供影响 HDL 实现和综合逻辑的额外配置选项。

HDL 架构

此模块具有一个默认 HDL 架构。

HDL 模块属性

ConstrainedOutputPipeline	通过移动设计中现有延迟的方式来放置在输出端的寄存器的数量。分布式流水线不会重新分发这些寄存器。默认值为 `0`。有关详细信息，请参阅ConstrainedOutputPipeline (HDL Coder)。
InputPipeline	要在生成的代码中插入的输入流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅InputPipeline (HDL Coder)。
OutputPipeline	要在生成的代码中插入的输出流水线阶段数。分布式流水线和受限输出流水线可以移动这些寄存器。默认值为 `0`。有关详细信息，请参阅OutputPipeline (HDL Coder)。

版本历史记录

在 R2006a 之前推出

全部展开

R2025a: 模块对话框和代码生成的增强功能

更新后的模块对话框允许您在表中指定逻辑表达式。您不再需要以逗号分隔的列表形式指定 elseif 表达式。此更改使整体逻辑流更易于可视化和解析。该表还包含新的操作按钮，允许您添加、删除和上下移动 if-else 表达式。这些按钮帮助您根据建模需求组织表达式。此外，新表达式编辑器框允许您编辑复杂表达式。
生成的代码包含 if-else 表达式。此更改可防止包含 switch-case 语句并增强生成代码的可读性。

另请参阅

Subsystem | Action Port | If Action Subsystem

主题

选择子系统执行

If

描述

示例

Simulink 子系统语义

If-Then-Else 模块

Modeling Clutch Lock-Up Using If Blocks

限制

端口

输入

Logical operands — 用于计算逻辑表达式的值 标量 | 向量

输出

Action — 用于 If Action Subsystem 模块的动作信号 标量

参数

输入数目 — 指定输入端口个数 1 (默认) | 整数

编程用法

显示 else 条件 — 控制 else 端口的显示 on (默认) | off

编程用法

启用过零检测 — 控制过零检测 on (默认) | off

编程用法

在生成的代码中提供 if-else 语句 — 在从 If 模块生成的代码中仅包含 if-else 语句的选项 off (默认) | on

编程用法

if — 逻辑表达式 u1 > 0 (默认) | 逻辑表达式

编程用法

elseif — 逻辑表达式 空 (默认) | 逻辑表达式列表

编程用法

模块特性

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

版本历史记录

R2025a: 模块对话框和代码生成的增强功能

另请参阅

主题

Logical operands — 用于计算逻辑表达式的值
标量 | 向量

Action — 用于 If Action Subsystem 模块的动作信号
标量

输入数目 — 指定输入端口个数
`1` (默认) | 整数

显示 else 条件 — 控制 else 端口的显示
`on` (默认) | `off`

启用过零检测 — 控制过零检测
`on` (默认) | `off`

在生成的代码中提供 if-else 语句 — 在从 If 模块生成的代码中仅包含 if-else 语句的选项
`off` (默认) | `on`

if — 逻辑表达式
`u1 > 0` (默认) | 逻辑表达式

elseif — 逻辑表达式
空 (默认) | 逻辑表达式列表

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。