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: int | double | 从头部出队;调用前必须确认非空 |
LIFO_PUT(queueId, value) | queueId: int,value: 数值 | bool | 压入栈顶;队满返回 false |
LIFO_POP(queueId) | queueId: int | double | 弹出栈顶;调用前必须确认非空 |
Q_EMPTY(queueId) | queueId: int | bool | 队列为空时返回 true |
Q_FULL(queueId) | queueId: int | bool | 队列已满时返回 true |
Q_COUNT(queueId) | queueId: int | int | 返回当前元素数 |
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及任意可增长集合。- 运行时按键动态插入或删除的映射表。
- 扫描内打开文件再填充集合。