harmony 鸿蒙Doubly Linked List
Doubly Linked List
Basic Concepts
A doubly linked list (DLL) is a linked data structure that consists of a set of sequentially linked records called nodes. Each node contains a pointer to the previous node and a pointer to the next node in the sequence of nodes. The pointer head is unique.
A DLL allows access from a list node to its next node and also the previous node on the list. This data structure facilitates data search, especially traversal of a large amount of data. The symmetry of the DLL also makes operations, such as insertion and deletion, easy. However, pay attention to the pointer direction when performing operations.
Function Description
The table below describes APIs available for the DLL. For more details about the APIs, see the API reference.
| Category | Description |
|---|---|
| Initializing and deleting a DLL | LOS_ListInit: initializes a DLL node as a DLL. LOS_DL_LIST_HEAD: Defines a DLL node and initializes the node as a DLL. LOS_ListDelInit: deletes a DLL. |
| Adding a node | LOS_ListAdd: adds a node to the head of a DLL. LOS_ListTailInsert: inserts a node to the tail of a DLL. |
| Deleting a node | LOS_ListDelete: deletes a node from this DLL. LOS_ListDelInit: deletes a node from this DLL and uses this node to initialize the DLL. |
| Checking a DLL | LOS_ListEmpty: checks whether a DLL is empty. |
| Obtaining structure information | LOS_DL_LIST_ENTRY: obtains the address of the structure that contains the DLL. The first input parameter of the API indicates a node in the list, the second input parameter indicates the name of the structure to be obtained, and the third input parameter indicates the name of the DLL in the structure. LOS_OFF_SET_OF: obtains the offset of a member in the specified structure relative to the start address of the structure. |
| Traversing a DLL | LOS_DL_LIST_FOR_EACH: traverses a DLL. LOS_DL_LIST_FOR_EACH_SAFE: traverses the DLL and stores the subsequent nodes of the current node for security verification. |
| Traversing the structure that contains a DLL | - LOS_DL_LIST_FOR_EACH_ENTRY: traverses a DLL and obtains the address of the structure that contains the linked list node. LOS_DL_LIST_FOR_EACH_ENTRY_SAFE: traverses a DLL, obtains the address of the structure that contains the linked list node, and stores the address of the structure that contains the subsequent node of the current node. |
How to Develop
The typical development process of the DLL is as follows:
Call LOS_ListInit or LOS_DL_LIST_HEAD to initialize a DLL.
Call LOS_ListAdd to add a node into the DLL.
Call LOS_ListTailInsert to insert a node into the tail of the DLL.
Call LOS_ListDelete to delete the specified node.
Call LOS_ListEmpty to check whether the DLL is empty.
Call LOS_ListDelInit to delete the specified node and initialize the DLL based on the node.
NOTE
Pay attention to the operations operations of the front and back pointer of the node.
The DLL APIs are underlying interfaces and do not check whether the input parameters are empty. You must ensure that the input parameters are valid.
If the memory of a linked list node is dynamically allocated, release the memory when deleting the node.
Development Example
Example Description
This example implements the following:
Initialize the DLL.
Add nodes.
Delete nodes.
Check the operation result.
Sample Code
The sample code is as follows:
The sample code is compiled and verified in ./kernel/liteos_m/testsuites/src/osTest.c. Call ExampleList in TestTaskEntry.
#include "stdio.h"
#include "los_list.h"
STATIC UINT32 ExampleList(VOID)
{
LOS_DL_LIST listHead = {NULL,NULL};
LOS_DL_LIST listNode1 = {NULL,NULL};
LOS_DL_LIST listNode2 = {NULL,NULL};
/* Initialize a DLL. */
printf("Initial head\n");
LOS_ListInit(&listHead);
/* Add node 1 and node 2 and verify their relationship. */
LOS_ListAdd(&listHead, &listNode1);
if (listNode1.pstNext == &listHead && listNode1.pstPrev == &listHead) {
printf("Add listNode1 success\n");
}
LOS_ListTailInsert(&listHead, &listNode2);
if (listNode2.pstNext == &listHead && listNode2.pstPrev == &listNode1) {
printf("Tail insert listNode2 success\n");
}
/* Delete the two nodes. */
LOS_ListDelete(&listNode1);
LOS_ListDelete(&listNode2);
/* Check whether the DLL is empty. */
if (LOS_ListEmpty(&listHead)) {
printf("Delete success\n");
}
return LOS_OK;
}
Verification
The development is successful if the return result is as follows:
Initial head
Add listNode1 success
Tail insert listNode2 success
Delete success
你可能感兴趣的鸿蒙文章
harmony 鸿蒙Kernel Coding Specification
- 所属分类： 后端技术
- 本文标签：
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
6、 golang
-
8、 openharmony