2.1 ATK2(开源AUTOSAR OS)代码解析-链表队列

2.1 链表队列

​ ATK2定义了链表队列的数据形式，利用链表队列可动态管理OS各项服务实例的增加或减少。链表队列的相关函数实现定义在/include/queue.h中。

2.1.1 链表队列-类型定义

2.1.1.1 链表队列定义

​ 通过指针可以遍历整个队列的内容。

typedef struct queue {
	struct queue	*p_next;    //指向链表队列下一对象
	struct queue	*p_prev;    //指向链表队列上一对象
} QUEUE;

2.1.2 链表队列-功能函数

​ 队列相关功能函数都采用内联的形式定义在/include/queue.h中，LOCAL_INLINE == static inline

2.1.2.1 队列初始化

LOCAL_INLINE void queue_initialize(QUEUE *p_queue)//输入：需初始化队列
{
    /***将队列的头和尾都指向自己***/
	p_queue->p_prev = p_queue; 
	p_queue->p_next = p_queue;
}

2.1.2.2 队列前置插入节点

LOCAL_INLINE void queue_insert_prev(QUEUE *p_queue, QUEUE *p_entry)//输入：被插入队列，节点
{
    /***在p_queue前置位插入p_entry节点***/
	p_entry->p_prev = p_queue->p_prev;
	p_entry->p_next = p_queue;
	p_queue->p_prev->p_next = p_entry;
	p_queue->p_prev = p_entry;
}

2.1.2.3 队列后置插入节点

LOCAL_INLINE void queue_insert_next(QUEUE *p_queue, QUEUE *p_entry)//输入：被插入队列，节点
{
    /***在p_queue后置位插入p_entry节点***/
	p_entry->p_next = p_queue->p_next;
	p_entry->p_prev = p_queue;
	p_queue->p_next->p_prev = p_entry;
	p_queue->p_next = p_entry;
}

2.1.2.4 队列删除指定节点

LOCAL_INLINE void queue_delete(QUEUE *p_entry)//输入：删除的节点
{
    /***在p_entry所处队列中删除p_entry节点***/
	p_entry->p_prev->p_next = p_entry->p_next;
	p_entry->p_next->p_prev = p_entry->p_prev;
}

2.1.2.5 取出队列的下一节点(头节点)

LOCAL_INLINE QUEUE *queue_delete_next(QUEUE *p_queue)//输入：待取出的队列
{
	QUEUE *p_entry;
	ASSERT(p_queue->p_next != p_queue);//断言当前队列不能为空
	p_entry = p_queue->p_next;
	p_queue->p_next = p_entry->p_next;
	p_entry->p_next->p_prev = p_queue;
	return(p_entry);//返回队列的下一节点，也可以理解为取出队列的头节点
}

2.1.2.6 检查队列是否为空

LOCAL_INLINE boolean queue_empty(const QUEUE *p_queue)//输入：待检查的队列
{
	return(p_queue->p_next == p_queue);//队列头节点等于自己说明为空，返回ture
}

2.1.3 操作解析

• 使用queue_initialize(queue)初始化列表：

图2：空列表示意图

• 在空列表queue中插入queue_1节点,既可使用前置插入queue_insert_prev(queue,queue_1),也可使用后置插入函数queue_insert_next(queue,queue_1)：

图3：queue插入头节点

• 在图3queue列表中继续前置插入queue_insert_prev(queue,queue_2),此时头节点依然为queue_1:

图4：queue列表前置插入queue_2

• 在图3queue列表中后置插入queue_insert_next(queue,queue_2),此时头节点变为了queue_2:

图5：queue列表后置插入queue_2