FreeRTOS——链表（1）

什么是链表？？？
可以结合数组来看，链表和数组差不多，数组是连续存储，不能动态扩展，删除，
链表：可以把零散的空余空间串联起来，内存利用率高，有数据增加就串联更多的空间，有数据减少就删除多余的空间

链表由节点组成，根据节点的指向不同可以分为单链表，循环链表，双向循环链表
单链表（最基本链表结构）
单链表中节点由数据和指向下一个节点的指针构成，最后一个节点指针指向空

循环链表
循环链表和单链表相同，最后一个节点的指针指向第一个节点

双向循环链表
双向循环链表与循环链表相比，不仅仅有指向下一个节点的指针，还指向上一个节点的指针

链表的插入

链表的删除
链表的删除，如图，尽管节点2的指针依然指向上一个节点和下一个节点，但是节点一和节点三的指针是互相指向的，可以忽略节点2；

下面以双向循环链表为例，看看是如何进行链表的插入与删除

链表插入与删除代码实现
1）定义节点和链表
定义节点中的成员：数据，指向下一个节点的指针，指向上一个节点的指针
定义链表中的成员：链表节点数量，根节点

2）初始化节点和链表
节点的初始化给节点的数据赋值
链表的初始化，链表当前没有其他节点，根节点的前后指针都指向根节点，链表节点计数器初始化为1（只有一个根节点）

3）链表的插入
链表的插入是以根节点作为参考点，始终插入它的前面

4）链表的删除

https://blog.csdn.net/m0_51095029/article/details/120074356

#include "list.h"   

void vListInitialiseItem( ListItem_t * const pxItem )
{
     /* 鍒濆鍖栬鑺傜偣鎵€鍦ㄩ摼琛ㄤ负绌?*/
    pxItem->pvContainer = NULL;
}
void vListInitialise(List_t * const pxList)
{
    /*閾捐〃鏍硅妭鐐瑰垵濮嬪寲*/
    pxList->pxIndex = (ListItem_t * )&(pxList->xListEnd);
    pxList->xListEnd.xItemValue = portMAX_DELAY;
    pxList->xListEnd.pxNext = (ListItem_t * )&(pxList->xListEnd);
    pxList->xListEnd.pxPrevious = (ListItem_t * )&(pxList->xListEnd);
    pxList->uxNumberOfItems = (UBaseType_t)0U;
}
void vListInsertEnd(List_t * const pxList,ListItem_t * const pxNewListItem)
{
    /*灏嗚妭鐐规彃鍏ラ摼琛ㄥ熬閮?/
    ListItem_t * const pxIndex = pxList->pxIndex;

    pxNewListItem->pxNext = pxIndex;
    pxNewListItem->pxPrevious = pxIndex->pxPrevious;
    pxIndex->pxPrevious->pxNext = pxNewListItem;
    pxIndex->pxPrevious = pxNewListItem;

    pxNewListItem->pvContainer = (void * )pxList;
    (pxList->uxNumberOfItems)++; 
}
void vListInsert(List_t * const pxList, ListItem_t * const pxNewListItem)
{
    /*灏嗚妭鐐规寜鐓у崌搴忔帓鍒楁彃鍏ュ埌閾捐〃*/
    ListItem_t * pxIterator;

    const TickType_t xValueOfInsertion = pxNewListItem->xItemValue;

    if(xValueOfInsertion == portMAX_DELAY)
    {
        pxIterator = pxList->xListEnd.pxPrevious;
    }
    else
    {
        for(pxIterator = (ListItem_t * )&(pxList->xListEnd);
            pxIterator->pxNext->xItemValue <= xValueOfInsertion;
            pxIterator = pxIterator->pxNext)
            {
                /*涓嶅仛浠讳綍浜?/
            }
    }
    pxNewListItem->pxNext = pxIterator->pxNext;
    pxNewListItem->pxNext->pxPrevious = pxNewListItem;
    pxNewListItem->pxPrevious = pxIterator;
    pxIterator->pxNext = pxNewListItem;

    pxNewListItem->pvContainer = (void * )pxList;
    (pxList->uxNumberOfItems)++;
}
UBaseType_t uxListRemove(ListItem_t * const pxItemToRemove)
{
    /*灏嗚妭鐐逛粠閾捐〃鍒犻櫎*/
    List_t * const pxList = (List_t * )pxItemToRemove->pvContainer;
    pxItemToRemove->pxNext->pxPrevious = pxItemToRemove->pxPrevious;
    pxItemToRemove->pxPrevious->pxNext = pxItemToRemove->pxNext;

    if(pxList->pxIndex == pxItemToRemove)
    {
        pxList->pxIndex = pxItemToRemove->pxPrevious;
    }
    pxItemToRemove->pvContainer = NULL;
    (pxList->uxNumberOfItems)--;

    return pxList->uxNumberOfItems;
}

list.h

struct xLIST_ITEM
{
    /* 链表节点数据结构定义 */
	TickType_t xItemValue;             /* 辅助值，用于帮助节点做顺序排列 */			
	struct xLIST_ITEM *  pxNext;       /* 指向链表下一个节点 */		
	struct xLIST_ITEM *  pxPrevious;   /* 指向链表前一个节点 */	
	void * pvOwner;					   /* 指向拥有该节点的内核对象，通常是TCB */
	void *  pvContainer;		       /* 指向该节点所在的链表 */
};
typedef struct xLIST_ITEM ListItem_t;  /* 节点数据类型重定义 */

struct xMINI_LIST_ITEM
{
    /* 链表精简节点数据结构定义 */
    TickType_t xItemValue;            /*辅助值，用于帮助节点做升序排列*/
    struct xLIST_ITEM * pxNext;       /*指向链表的下一个节点*/
    struct xLIST_ITEM * pxPrevious;   /*指向链表前一个结点*/
};
typedef struct xMINI_LIST_ITEM MiniListItem_t;

typedef struct xLIST
{
    /* 链表根节点数据结构定义 */
    UBaseType_t uxNumberOfItems;      /*链表节点计数器*/
    ListItem_t * pxIndex;             /*链表节点索引指针*/
    MiniListItem_t xListEnd;          /*链表最后一个节点*/
} List_t;

/* 初始化节点的拥有者 */
#define listSET_LIST_ITEM_OWNER(pxListItem, pxOwner)    ((pxListItem)->pvOwner = (void * )(pxOwner))
/* 获取节点拥有者 */
#define listGET_LIST_ITEM_OWNER(pxListItem)    ((pxListItem)->pvOwner)

/* 初始化节点排序辅助值 */
#define listSET_LIST_ITEM_VALUE(pxListItem, xValue)    ((pxListItem)->xItemValue = (xValue))

/* 获取节点排序辅助值 */
#define listGET_LIST_ITEM_VALUE(pxListItem)    ((pxListItem)->xItemValue)

/* 获取链表根节点的节点计数器的值 */
#define listGET_ITEM_VALUE_OF_HEAD_ENTRY(pxList)    (((pxList)->xListEnd).pxNext->xItemValue)

/* 获取链表的入口节点 */
#define listGET_HEAD_ENTRY(pxList)    (((pxList)->xListEnd).pxNext)

/* 获取链表的第一个节点 */
#define listGET_NEXT(pxListItem)    ((pxListItem)->pxNext)

/* 获取链表的最后一个节点 */
#define listGET_END_MARKER(pxList)    ((ListItem_t const * )(&((pxList)->xListEnd)))

/* 判断链表是否为空 */
#define listLIST_IS_EMPTY(pxList)    ((BaseType_t)((pxList)->uxNumberOfItems == (UBaseType_t)0))

/* 获取链表的节点数 */
#define listCURRENT_LIST_LENGTH(pxList)    ((pxList)->uxNumberOfItems)

/* 获取链表节点的OWNER，即TCB */
#define listGET_OWNER_OF_NEXT_ENTRY(pxTCB, pxList)										\
{																						\
	List_t * const pxConstList = (pxList);											    \
	/* 节点索引指向链表第一个节点调整节点索引指针，指向下一个节点，
    如果当前链表有N个节点，当第N次调用该函数时，pxIndex则指向第N个节点 */                   \
	(pxConstList)->pxIndex = (pxConstList)->pxIndex->pxNext;							\
	/* 当前链表为空 */                                                                   \
	if( (void * ) (pxConstList)->pxIndex == (void * )&((pxConstList)->xListEnd))	    \
	{																					\
		(pxConstList)->pxIndex = (pxConstList)->pxIndex->pxNext;						\
	}																					\
	/* 获取节点的OWNER，即TCB */                                                         \
	(pxTCB) = (pxConstList)->pxIndex->pvOwner;											\
}
#define listGET_OWNER_OF_HEAD_ENTRY( pxList )  ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )
void vListInitialise( List_t * const pxList );
void vListInitialiseItem( ListItem_t * const pxItem );
void vListInsertEnd( List_t * const pxList, ListItem_t * const pxNewListItem );
void vListInsert( List_t * const pxList, ListItem_t * const pxNewListItem );
UBaseType_t uxListRemove( ListItem_t * const pxItemToRemove );