/*******************************************************************
*
* file name: DoubleLinkedList.c
* author : Dazz
* date : 2024/04/23
* function : 用於學習雙向連結串列，並新增插入、刪除、查詢結點等函式
* note : None
*
* CopyRight (c) 2024-202x Dazz_24@163.com All Right Reseverd
*
* *****************************************************************/
#include <stdio.h>
#include <stdbool.h>
// 指的是雙向連結串列中的結點有效資料型別，使用者可以根據需要進行修改
typedef int DataType_t;
// 構造雙向連結串列的結點,連結串列中所有結點的資料型別應該是相同的
typedef struct DoubleLinkedList
{
DataType_t data; // 結點的資料域
struct DoubleLinkedList *prev; // 直接前驅的指標域
struct DoubleLinkedList *next; // 直接後繼的指標域
} DoubleLList_t;
/******************************************************
*
* name : DoubleLList_Create
* function : 建立一個空雙向連結串列，空連結串列應該有一個頭結點，對連結串列進行初始化
* argument ：None
* retval : 頭結點的地址
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 建立一個空雙向連結串列，空連結串列應該有一個頭結點，對連結串列進行初始化
DoubleLList_t *DoubleLList_Create(void)
{
// 1.建立一個頭結點並對頭結點申請記憶體
DoubleLList_t *Head = (DoubleLList_t *)calloc(1, sizeof(DoubleLList_t));
if (NULL == Head)
{
perror("Calloc memory for Head is Failed");
exit(-1);
}
// 2.對頭結點進行初始化，頭結點是不儲存資料域，指標域指向NULL
Head->prev = NULL;
Head->next = NULL;
// 3.把頭結點的地址返回即可
return Head;
}
// 建立新的結點，並對新結點進行初始化（資料域 + 指標域）
DoubleLList_t *DoubleLList_NewNode(DataType_t data)
{
// 1.建立一個新結點並對新結點申請記憶體
DoubleLList_t *New = (DoubleLList_t *)calloc(1, sizeof(DoubleLList_t));
if (NULL == New)
{
perror("Calloc memory for NewNode is Failed");
return NULL;
}
// 2.對新結點的資料域和指標域（2個）進行初始化
New->data = data;
New->prev = NULL;
New->next = NULL;
return New;
}
/******************************************************
*
* name : DoubleLList_HeadInsert
* function : 將新的結點插入在單向迴圈連結串列的頭部
* argument
* @Head : 頭結點的地址
* @data : 結點資料域的資料
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 頭插
bool DoubleLList_HeadInsert(DoubleLList_t *Head, DataType_t data)
{
// 建立新的結點，並對結點初始化
DoubleLList_t *New = DoubleLList_NewNode(data);
// 判斷連結串列是否為空連結串列
if (NULL == Head->next)
{
Head->next = New;
return true;
}
// 將新的結點的指標域的next指向首結點
New->next = Head->next;
// 將首結點的指標域的prev指向新的結點
Head->next->prev = New;
// 將頭結點的指標域指向新結點
Head->next = New;
return true;
}
/******************************************************
*
* name : DoubleLLis_TailInsert
* function : 將新的結點插入在雙向連結串列的尾部
* argument
* @Head : 頭結點的地址
* @data : 結點資料域的資料
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 尾插
bool DoubleLList_TailInsert(DoubleLList_t *Head, DataType_t data)
{
// 建立新的結點，並對結點初始化
DoubleLList_t *New = DoubleLList_NewNode(data);
// 判斷連結串列是否為空連結串列
if (NULL == Head->next)
{
Head->next = New;
return true;
}
// 備份頭結點
DoubleLList_t *phead = Head;
// 遍歷連結串列，找到尾結點
while (phead->next)
{
phead = phead->next;
}
// 將尾結點的指標域的next指向新結點
phead->next = New;
// 將新結點指標域的prev指向尾結點
New->prev = phead;
return true;
}
/******************************************************
*
* name : DoubleLList_DestInsert
* function : 將新的結點插入在雙向連結串列的指定位置的後面
* argument
* @head : 頭結點的地址
* @data : 結點資料域的資料
* @destval : 需要插入位置的結點的資料域
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 指定位置插入
bool DoubleLList_DestInsert(DoubleLList_t *Head, DataType_t destval, DataType_t data)
{
// 建立新的結點，並對結點初始化
DoubleLList_t *New = DoubleLList_NewNode(data);
// 判斷連結串列是否為空連結串列
if (NULL == Head->next)
{
printf("該連結串列為空連結串列，沒有該指定位置\n");
return false;
}
// 備份頭結點
DoubleLList_t *phead;
// 遍歷列表，找到插入位置
while (phead->next)
{
phead = phead->next;
if (destval == phead->data)
{
break;
}
}
if (NULL == phead->next && destval != phead->data)
{
printf("列表中沒有該資料\n");
return false;
}
// 將新結點的指標域的next指向目標結點的直接後驅
New->next = phead->next;
// 將目標結點的直接後驅的指標域的prev指向新結點
phead->next->prev = New;
// 將新結點的指標域的prev指向指定結點
New->prev = phead;
// 將指點結點的指標域的next指向New；
phead->next = New;
return true;
}
/******************************************************
*
* name : DoubleLList_HeadDel
* function : 刪除連結串列的首結點
* argument
* @head : 頭結點的地址
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 頭刪
bool DoubleLList_HeadDel(DoubleLList_t *Head)
{
// 判斷連結串列是否為空
if (Head == Head->next)
{
printf("連結串列為空\n");
return false;
}
// 將首結點做備份
DoubleLList_t *temp = Head->next;
// 將頭節點的指標域的next指向首結點的直接後驅
Head->next = Head->next->next;
// 將首結點的指標域的next指向NULL
temp->next = NULL;
// 將首結點的直接後繼的指標域的prev指向NULL
Head->next->prev = NULL;
// 釋放首結點
free(temp);
return true;
}
/******************************************************
*
* name : DoubleLList_HailDel
* function : 刪除連結串列的尾結點
* argument
* @head : 頭結點的地址
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 尾刪
bool DoubleLList_HailDel(DoubleLList_t *Head)
{
// 判斷連結串列是否為空
if (Head == Head->next)
{
printf("連結串列為空\n");
return false;
}
// 對Head做備份
DoubleLList_t *phead = Head;
// 遍歷連結串列，找到尾結點
while (phead->next)
{
phead = phead->next;
}
// 將尾結點的直接前驅的指標域的next指向NULL
phead->prev->next = NULL;
// 將尾結點指標域的prev指向NULL；
phead->prev = NULL;
// 釋放尾結點
free(phead);
return true;
}
/******************************************************
*
* name : CircLList_DestNode
* function : 將連結串列的指定結點刪除
* argument
* @head : 頭結點的地址
* @destval : 需要插入位置的結點的資料域
*
* retval : 成功為1，否則為0
* author : Dazz
* date : 2024/4/23
* note : None
*
* *******************************************************/
// 指定刪
bool DoubleLList_DestNode(DoubleLList_t *Head, DataType_t destval)
{
// 判斷連結串列是否為空
if (Head == Head->next)
{
printf("連結串列為空\n");
return false;
}
// 備份頭結點
DoubleLList_t *phead = Head;
// 遍歷連結串列，找到指定位置
while (phead->next)
{
phead = phead->next;
if (destval == phead->data)
{
break;
}
}
if (NULL == phead->next && destval != phead->data)
{
printf("找不到該結點,請重新傳參\n");
return false;
}
// 將目標結點的直接前驅指標域的next指向目標結點的直接後驅
phead->prev->next = phead->next;
// 將目標結點的直接後驅的指標域的prev指向目標結點的直接前驅
phead->next->prev = phead->prev;
// 將目標結點的指標域的prev指向NULL
phead->prev = NULL;
// 將目標結點的指標域的next指向NULL
phead->next = NULL;
// 釋放目標結點
free(phead);
return true;
}
int main(int argc, char const *argv[])
{
return 0;
}