跳到主要内容

SCL 数组与队列

本页说明什么时候使用定长数组,什么时候使用运行时固定队列。List、字典、哈希集合和通用动态集合当前不可用。容量必须在编译期或运行时配置中有明确上限。

定长数组​

int[] samples = new int[8];
int count = 0;

for (int index = 0; index < samples.Length; index++)
{
samples[index] = index * 10;
count = count + 1;
}

数组适合固定通道、固定窗口和按下标访问。访问前始终检查边界。

FIFO 与 LIFO API​

系统提供 64 个队列实例,实例号范围为 0 到 63;每个实例容量为 64 个数值。实例号必须写成编译期常量。

API参数返回值说明
FIFO_PUT(queueId, value)queueId: int,value: 数值bool从尾部入队;队满返回 false
FIFO_GET(queueId)queueId: intdouble从头部出队;调用前必须确认非空
LIFO_PUT(queueId, value)queueId: int,value: 数值bool压入栈顶;队满返回 false
LIFO_POP(queueId)queueId: intdouble弹出栈顶;调用前必须确认非空
Q_EMPTY(queueId)queueId: intbool队列为空时返回 true
Q_FULL(queueId)queueId: intbool队列已满时返回 true
Q_COUNT(queueId)queueId: intint返回当前元素数

FIFO 示例​

bool accepted = false;
if (!Q_FULL(2))
{
accepted = FIFO_PUT(2, 42);
}

double sample = 0.0;
if (!Q_EMPTY(2))
{
sample = FIFO_GET(2);
}

int remaining = Q_COUNT(2);

LIFO 示例​

bool stored = false;
if (!Q_FULL(3))
{
stored = LIFO_PUT(3, 100);
}

double latest = 0.0;
if (!Q_EMPTY(3))
{
latest = LIFO_POP(3);
}

选择原则​

  • 固定通道或固定历史窗口:数组。
  • 先进先出任务:FIFO。
  • 后进先出回退步骤:LIFO。
  • 按键查找:使用固定编号和显式分支,不在扫描中构造动态字典。
  • 队列实例号是编译期常量,环形缓冲在扫描内执行,不把集合操作宣传成硬实时线程能力。

当前不可用​

  • List<T>、Dictionary、HashSet 及任意可增长集合。
  • 运行时按键动态插入或删除的映射表。
  • 扫描内打开文件再填充集合。