移动操作
本页收录标准函数分类“移动操作”下的完整 API 合同。
先进先出出队
FIFO_GET
可执行
标准函数 FIFO_GET:从静态绑定 FIFO 队列头部取出一个数值。
声明层
已声明验证层
已验证执行层
可执行
签名
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 队列尾部并返回成功标志。
声明层
已声明验证层
已验证执行层
可执行
签名
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 栈顶弹出一个数值。
声明层
已声明验证层
已验证执行层
可执行
签名
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 栈顶并返回成功标志。
声明层
已声明验证层
已验证执行层
可执行
签名
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:读取静态绑定队列中的当前元素数。
声明层
已声明验证层
已验证执行层
可执行
签名
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:判断静态绑定队列当前是否为空。
声明层
已声明验证层
已验证执行层
可执行
签名
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:判断静态绑定队列当前是否已满。
声明层
已声明验证层
已验证执行层
可执行
签名
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_ | 队列 ID | QUEUE_ID_OUT_OF_RANGE |
COMPILE_ARGUMENT_ERROR
COMPILE_ 编译参数:SCL 参数类型/范围/枚举校验
出现在 7 个 API 条目中。
- 缺少必需实参或参数类型不匹配时编译失败。
QUEUE_ID_OUT_OF_RANGE
QUEUE_ID_ 队列 ID
出现在 7 个 API 条目中。
- 队列 ID 不是 0..63 的编译期整数常量时编译失败。