跳到主要内容

比较器操作

共 3 个 API(3 个可执行)

本页收录标准函数分类“比较器操作”下的完整 API 合同。

多路分配​

DEMUX 可执行

标准函数 DEMUX:从单输入分配到 count 路输出的第 sel 路,其余路输出 0。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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:按零基索引从一个或多个候选值中选择。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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 之间选择一个值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

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) 时运行失败。