列表和列表项笔记

相关API函数

函数 vListInitialise()

​ 此函数用于初始化列表，在定义列表之后，需要先对其进行初始化，只有初始化后的列表， 才能够正常地被使用。列表初始化的过程，其实就是初始化列表中的成员变量。函数原型如下所示：

void vListInitialise(List_t * const pxList);

函数 vListInitialise()初始化后的列表结构示意图，如下图所示

函数 vListInitialise()无返回值。

函数 vListInitialiseItem()

​ 此函数用于初始化列表项，如同列表一样，在定义列表项之后，也需要先对其进行初始化， 只有初始化有的列表项，才能够被正常地使用。列表项初始化的过程，也是初始化列表项中的 成员变量。函数原型如下所示：

void vListInitialiseItem(ListItem_t * const pxItem);

函数 vListInitialiseItem()的形参描述，如下表所示：

函数 vListInitialiseItem()无返回值。

函数 vListInsertEnd()

​ 此函数用于将待插入列表的列表项插入到列表 pxIndex 指针指向列表项的前面，是一种无 序的插入方法。函数原型如下所示：

void vListInsertEnd(
    List_t * const pxList,
    ListItem_t * const pxNewListItem);

函数 vListInsertEnd()的形参描述，如下表所示：

函数 vListInsertEnd()无返回值。

函数 vListInsert()

​ 此函数用于将待插入列表的列表项按照列表项值升序排序的顺序，有序地插入到列表中。 函数原型如下所示：

void vListInsert(
    List_t * const pxList,
    ListItem_t * const pxNewListItem);

函数 vListInsert()的形参描述，如下表所示：

函数 vListInsert()无返回值。

函数 uxListRemove()

此函数用于将列表项从列表项所在列表中移除，函数原型如下所示：

UBaseType_t uxListRemove(ListItem_t * const pxItemToRemove);

函数 uxListRemove()的形参描述，如下表所示：

函数 uxListRemove()的返回值，如下表所示：