跳到主要内容

移动操作

共 7 个 API(7 个可执行)

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

先进先出出队​

FIFO_GET 可执行

标准函数 FIFO_GET:从静态绑定 FIFO 队列头部取出一个数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL FIFO_GET(INT id)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态 FIFO 实例号。

返回值​

returnLREAL
队头数值;空队列返回 NaN。

行为说明​

  • 成功读取后移除队头元素。
  • 空队列返回 NaN。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

从 FIFO 0 读取最早样本。
LREAL sample = FIFO_GET(0);

相关 API​

暂无已核实关系。

先进先出入队​

FIFO_PUT 可执行

标准函数 FIFO_PUT:把数值放入静态绑定 FIFO 队列尾部并返回成功标志。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL FIFO_PUT(INT id, LREAL value)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态 FIFO 实例号。
valueLREAL
  • 输入
  • 必填
入队数值。

返回值​

returnBOOL
入队成功为 true,队列已满为 false。

行为说明​

  • 同一常量 id 的入队、出队和状态查询共享同一环形缓冲。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

把样本放入 FIFO 0。
BOOL accepted = FIFO_PUT(0, sample);

相关 API​

暂无已核实关系。

后进先出弹栈​

LIFO_POP 可执行

标准函数 LIFO_POP:从静态绑定 LIFO 栈顶弹出一个数值。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

LREAL LIFO_POP(INT id)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态 LIFO 实例号。

返回值​

returnLREAL
栈顶数值;空栈返回 NaN。

行为说明​

  • 成功读取后移除栈顶元素。
  • 空栈返回 NaN。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

从 LIFO 0 弹出最近样本。
LREAL sample = LIFO_POP(0);

相关 API​

暂无已核实关系。

后进先出入栈​

LIFO_PUT 可执行

标准函数 LIFO_PUT:把数值压入静态绑定 LIFO 栈顶并返回成功标志。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL LIFO_PUT(INT id, LREAL value)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态 LIFO 实例号。
valueLREAL
  • 输入
  • 必填
入栈数值。

返回值​

returnBOOL
入栈成功为 true,栈已满为 false。

行为说明​

  • 同一常量 id 的入栈、出栈和状态查询共享同一环形缓冲。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

把样本压入 LIFO 0。
BOOL accepted = LIFO_PUT(0, sample);

相关 API​

暂无已核实关系。

读取队列数量​

Q_COUNT 可执行

标准函数 Q_COUNT:读取静态绑定队列中的当前元素数。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

INT Q_COUNT(INT id)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态队列实例号。

返回值​

returnINT
当前队列元素数。

行为说明​

  • 查询不移除元素。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

读取 FIFO 0 的待处理数量。
INT pending = Q_COUNT(0);

相关 API​

暂无已核实关系。

判断队列为空​

Q_EMPTY 可执行

标准函数 Q_EMPTY:判断静态绑定队列当前是否为空。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL Q_EMPTY(INT id)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态队列实例号。

返回值​

returnBOOL
队列为空时为 true。

行为说明​

  • 查询不移除元素。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

检查 FIFO 0 是否为空。
BOOL empty = Q_EMPTY(0);

相关 API​

暂无已核实关系。

判断队列已满​

Q_FULL 可执行

标准函数 Q_FULL:判断静态绑定队列当前是否已满。

可执行
  1. 声明层

    已声明
  2. 验证层

    已验证
  3. 执行层

    可执行

签名​

BOOL Q_FULL(INT id)

参数​

idINT
  • 输入
  • 必填
  • 约束 必须是编译期常量。
静态队列实例号。

返回值​

returnBOOL
队列已满时为 true。

行为说明​

  • 查询不移除元素。
  • 队列 ID 范围 0..63;每队列固定容量为 64 个数值。

错误与限制​

此外,本 API 还可能触发以下共享错误码(详见共享错误码):COMPILE_ARGUMENT_ERROR、QUEUE_ID_OUT_OF_RANGE。

示例​

检查 FIFO 0 是否已满。
BOOL full = Q_FULL(0);

相关 API​

暂无已核实关系。


共享错误码​

以下错误码在本分类的多个 API 条目中重复出现,统一在此说明以避免冗余。各条目的"错误与限制"小节仅列出该 API 专属的错误码。

错误码前缀对照​

前缀含义示例
COMPILE_编译参数:SCL 参数类型/范围/枚举校验COMPILE_ARGUMENT_ERROR
QUEUE_ID_队列 IDQUEUE_ID_OUT_OF_RANGE

COMPILE_ARGUMENT_ERROR​

COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验

出现在 7 个 API 条目中。

  • 缺少必需实参或参数类型不匹配时编译失败。

QUEUE_ID_OUT_OF_RANGE​

QUEUE_ID_ 队列 ID

出现在 7 个 API 条目中。

  • 队列 ID 不是 0..63 的编译期整数常量时编译失败。