列表和列表项

发布于 2023-08-11  297 次阅读


内容纲要

列表和列表项笔记

相关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()的返回值,如下表所示:

世界のネズミは彼らが望むものに依存し、彼らは彼ら自身から誰も求めません
最后更新于 2023-08-27