弄个例子要说明下插入的过程。就是vListInsert的执行过程。
编程如下:
#include "list.h"
volatile xList list;
volatile xListItem item1 = {1};
volatile xListItem item2 = {2};
volatile xListItem item3 = {3};
volatile xListItem item4 = {4};
int main(void) {
vListInitialise((xList *) &list);
vListInitialiseItem( (xListItem *) &item1);
vListInitialiseItem( (xListItem *) &item2);
vListInitialiseItem( (xListItem *) &item3);
vListInitialiseItem( (xListItem *) &item4);
vListInsertEnd((xList *) & (list), (xListItem *)&item1);
vListInsertEnd((xList *) & (list), (xListItem *)&item2);
vListInsertEnd((xList *) & (list), (xListItem *)&item4);
vListInsert((xList *) & (list), (xListItem *)&item3);
while (1);
}</span>
上面的这个例子实现的是在节点2和节点4之间插入节点3的例子。
我们这里就分析vListInsert这个函数,为什么先分析这个函数呢?因为感觉这个函数比vListInsertEnd要容易理解一些。好看下“插入”函数,如下:
void vListInsert(xList *pxList, xListItem *pxNewListItem) {
volatile xListItem *pxIterator;
portTickType xValueOfInsertion;
xValueOfInsertion = pxNewListItem->xItemValue;
if (xValueOfInsertion == portMAX_DELAY) { //[A]
for (pxIterator = (xListItem *) & (pxList->xListEnd);
pxIterator->pxNext->xItemValue < xValueOfInsertion;
pxIterator = pxIterator->pxNext) {
}
}
else {
for (pxIterator = (xListItem *) & (pxList->xListEnd); //[B]
pxIterator->pxNext->xItemValue <= xValueOfInsertion; //[C]
pxIterator = pxIterator->pxNext) { //[D]
}
}
pxNewListItem->pxNext = pxIterator->pxNext; //[E]
pxNewListItem->pxNext->pxPrevious = (volatile xListItem *) pxNewListItem; //[F]
pxNewListItem->pxPrevious = pxIterator; //[G]
pxIterator->pxNext = (volatile xListItem *) pxNewListItem; //[H]
pxNewListItem->pvContainer = (void *) pxList;
(pxList->uxNumberOfItems)++;
}
就是分析如何执行函数vListInsert((xList *) & (list), (xListItem *)&item3);的。首先函数的参数item3决定了xValueOfInsertion 的值为3。因为3不等于portMAX_DELAY,所以由[A]跳到了[B]。然后由[B][C][D]构成的for循环主要是为了得到pxIterator的值是多少。那么pxIterator是几呢?好好分析一下,发现pxIterator的值是2.
这样就是要在2和4之间插入3。
/-----------------------------------------------------------------------------------------------------------------------------------------------------------------/
那么[E][F][G][H]是干啥的呢?想想看,要想在2和4之间插入3,那么有几个地方的值要改变,有2的next、4的previous,还有3的previous和next。就是总共有4个地方要变化。
/-----------------------------------------------------------------------------------------------------------------------------------------------------------------/
[E]的解释是:3的next=插入前2的next
[F]的解释是:4的previous=3
[G]的解释是:3的previous=2
[H]的解释是:2的next=3