比较器操作
本页收录标准函数分类“比较器操作”下的完整 API 合同。
多路分配
DEMUX
可执行
标准函数 DEMUX:从单输入分配到 count 路输出的第 sel 路,其余路输出 0。
可执行
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL DEMUX(LREAL input, INT index, INT channelCount)
参数
inputLREAL- 待分配输入值。
indexINT- 目标输出通道索引。
channelCountINT- 输出通道总数。
返回值
returnLREAL- 标量表达式只取得最后一路;完整通道组只供多输出调用使用。
行为说明
- 运行时按 OUT0..OUT(channelCount-1) 顺序压回通道值,仅 index 路为 input,其余为 0。
- 普通标量赋值只能消费最后一路。
- channelCount 范围 1..256,index 必须在 [0,channelCount)。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、SELECTOR_OUT_OF_RANGE。
示例
把信号分配到第 channel 路。
LREAL result = DEMUX(signal, channel, 4);
相关 API
暂无已核实关系。
索引多路选择
MUX
可执行
标准函数 MUX:按零基索引从一个或多个候选值中选择。
可执行
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL MUX(INT index, LREAL value0)
参数
indexINT- 零基候选索引。
value0LREAL- 第一个候选值;可继续追加同类型候选。
返回值
returnLREAL- 索引选中的候选值。
行为说明
- 调用至少包含 index 和一个候选值。
- 候选数量在编译期确定。
- 候选数量范围 1..256;索引越界时运行失败。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、SELECTOR_OUT_OF_RANGE。
示例
按模式选择设定值。
LREAL setpoint = MUX(mode, idleValue, runValue, serviceValue);
相关 API
暂无已核实关系。
布尔选择
SEL
可执行
标准函数 SEL:按 gate 在 in0 与 in1 之间选择一个值。
可执行
声明层
已声明验证层
已验证执行层
可执行
签名
LREAL SEL(BOOL gate, LREAL in0, LREAL in1)
参数
gateBOOL- 选择条件。
in0LREAL- gate 为 false 时的值。
in1LREAL- gate 为 true 时的值。
返回值
returnLREAL- 被选择的输入值。
行为说明
- gate=false 返回 in0;gate=true 返回 in1。
错误与限制
此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR。
示例
按条件选择主值或备用值。
LREAL command = SEL(useBackup, primary, backup);
相关 API
暂无已核实关系。
共享错误码
以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。
错误码前缀对照
| 前缀 | 含义 | 示例 |
|---|---|---|
COMPILE_ | 编译参数:SCL 参数类型/范围/枚举校验 | COMPILE_ARGUMENT_ERROR |
COMPILE_ARGUMENT_ERROR
COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验
出现在 3 个 API 条目中。
- 缺少必需实参或参数类型不匹配时编译失败。
SELECTOR_OUT_OF_RANGE
出现在 2 个 API 条目中。
- 候选/通道数不在 1..256,或索引不在 [0,count) 时运行失败。