开发指导
功能
Huawei LiteOS的双向链表模块为用户提供下面几种功能，接口详细信息可以查看API参考。
功能分类 | 接口名 | 描述 |
|---|---|---|
初始化链表 | LOS_ListInit | 将指定节点初始化为双向链表节点 |
LOS_DL_LIST_HEAD | 定义一个节点并初始化为双向链表节点 | |
增加节点 | LOS_ListAdd | 将指定节点插入到双向链表头端 |
LOS_ListHeadInsert | 将指定节点插入到双向链表头端，同LOS_ListAdd | |
LOS_ListTailInsert | 将指定节点插入到双向链表尾端 | |
删除节点 | LOS_ListDelete | 将指定节点从链表中删除 |
LOS_ListDelInit | 将指定节点从链表中删除，并使用该节点初始化链表 | |
判断双向链表是否为空 | LOS_ListEmpty | 判断链表是否为空 |
获取节点 | LOS_DL_LIST_LAST | 获取指定节点的前驱结点 |
LOS_DL_LIST_FIRST | 获取指定节点的后继结点 | |
获取结构体信息 | LOS_DL_LIST_ENTRY | 获取包含链表的结构体地址，接口的第一个入参表示的是链表中的某个节点，第二个入参是要获取的结构体名称，第三个入参是链表在该结构体中的名称 |
LOS_OFF_SET_OF | 获取指定结构体内的成员相对于结构体起始地址的偏移量 | |
遍历双向链表 | LOS_DL_LIST_FOR_EACH | 遍历双向链表 |
LOS_DL_LIST_FOR_EACH_SAFE | 遍历双向链表，并存储当前节点的后继节点用于安全校验 | |
遍历包含双向链表的结构体 | LOS_DL_LIST_FOR_EACH_ENTRY | 遍历指定双向链表，获取包含该链表节点的结构体地址 |
LOS_DL_LIST_FOR_EACH_ENTRY_SAFE | 遍历指定双向链表，获取包含该链表节点的结构体地址，并存储包含当前节点的后继节点的结构体地址 | |
LOS_DL_LIST_FOR_EACH_ENTRY_HOOK | 遍历指定双向链表，获取包含该链表节点的结构体地址，并在每次循环中调用钩子函数 |
开发流程
双向链表的典型开发流程：
- 调用LOS_ListInit/LOS_DL_LIST_HEAD初始双向链表。
- 调用LOS_ListAdd/LOS_ListHeadInsert向链表头部插入节点。
- 调用LOS_ListTailInsert向链表尾部插入节点。
- 调用LOS_ListDelete删除指定节点。
- 调用LOS_ListEmpty判断链表是否为空。
- 调用LOS_ListDelInit删除指定节点并以此节点初始化链表。
