雙向迴圈鏈表

原理與應用

雙向迴圈鏈表與雙向鏈表的區別：指的是雙向迴圈鏈表的首結點中的prev指針成員指向鏈表的尾結點，並且雙向迴圈鏈表的尾結點里的next指針成員指向鏈表的首結點，所以雙向迴圈鏈表也屬於環形結構。

雙向迴圈鏈表各功能實現

（1）為了管理雙向迴圈鏈表，需要構造頭結點的數據類型以及構造有效結點的數據類型

//指的是雙向迴圈鏈表中的結點有效數據類型，用戶可以根據需要進行修改
typedef int  DataType_t;

//構造雙向迴圈鏈表的結點,鏈表中所有結點的數據類型應該是相同的
typedef struct DoubleCirLinkedList
{
	DataType_t  		     data; //結點的數據域
	struct DoubleCirLinkedList	*prev; //直接前驅的指針域
	struct DoubleCirLinkedList	*next; //直接後繼的指針域

}DoubleCirLList_t;

(2)創建一個空鏈表，由於是使用頭結點，所以就需要申請頭結點的堆記憶體並初始化即可！

/********************************************************************
 *
 *	name	 :	DoubleCirLList_Create
 *	function :  創建一個空雙向迴圈鏈表，空鏈表應該有一個頭結點，對鏈表進行初始化
 *	argument :
 *				none
 *
 *	retval	 :  調用成功返回已經完成初始化的雙向迴圈鏈表的頭結點,否則退出程式
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
//創建一個空雙向迴圈鏈表，空鏈表應該有一個頭結點，對鏈表進行初始化
DoubleCirLList_t * DoubleCirLList_Create(void)
{
	//1.創建一個頭結點並對頭結點申請記憶體
	DoubleCirLList_t *Head = (DoubleCirLList_t *)calloc(1,sizeof(DoubleCirLList_t));
	if (NULL == Head)
	{
		perror("Calloc memory for Head is Failed");
		exit(-1); //程式異常退出
	}

	//2.對頭結點進行初始化，頭結點是不存儲數據域，指針域指向自身即可，體現“迴圈”
	Head->prev = Head;
	Head->next = Head;

	//3.把頭結點的地址返回即可
	return Head;
}

(3)創建新結點，為新結點申請堆記憶體並對新結點的數據域和指針域進行初始化，操作如下：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_NewNode
 *	function :  創建新的結點，並對新結點進行初始化（數據域 + 指針域(prev+next)）
 *	argument :
 *				@data 新節點需要存儲的數據
 *
 *	retval	 :  調用成功返回已經完成初始化的雙向鏈表的新節點,否則返回NULL
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
//創建新的結點，並對新結點進行初始化（數據域 + 指針域）
DoubleCirLList_t * DoubleCirLList_NewNode(DataType_t data)
{
	//1.創建一個新結點並對新結點申請記憶體
	DoubleCirLList_t *New = (DoubleCirLList_t *)calloc(1,sizeof(DoubleCirLList_t));
	if (NULL == New)
	{
		perror("Calloc memory for NewNode is Failed");
		return NULL;
	}

	//2.對新結點的數據域和指針域（2個）進行初始化,指針域指向結點自身，體現“迴圈”
	New->data = data;
	New->prev = New;
	New->next = New;

	return New;
}

(4)根據情況把新結點插入到鏈表中，此時可以分為尾部插入、頭部插入、指定位置插入：

頭插:

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_HeadInsert
 *	function :  將新節點頭插進雙向迴圈鏈表中
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/23
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_HeadInsert(DoubleCirLList_t *Head, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("HeadInsert is fail!\n");
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("HeadInsert of %d is success!\n", New->data);
		return;
	}

	// 1.將尾結點的next指向新節點
	Phead->prev->next = New;
	// 2.將新節點的prev指向尾結點
	New->prev = Phead->prev;
	// 3.將新節點的next指向首節點
	New->next = Phead;
	//4.將首節點的prev指向新節點
	Phead->prev = New;
	//5.將頭結點的next指向新節點
	Head->next = New;

	printf("HeadInsert of %d is success!\n", New->data);

	return;
}

尾插：

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_TailInsert
 *	function :  將新節點尾插進雙向鏈表中
 *	argument :
 *				@Head 雙向鏈表頭結點
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/23
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_TailInsert(DoubleCirLList_t *Head, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("TailInsert is fail!\n");
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("TailInsert of %d is success!\n", New->data);
		return;
	}

	//1.將新節點的prev指向尾結點
	New->prev = Phead->prev;
	//2.將尾結點的next指向新節點
	Phead->prev->next = New;
	//3.將新節點的next指向首節點
	New->next = Phead;
	//4.將首節點的prev指向新節點
	Phead->prev = New;

	printf("TailInsert of %d is success!\n", New->data);

	return;
}

指定位置插：

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_DestInsert
 *	function :  將新節點插進雙向迴圈鏈表指定位置中
 *	argument :
 *				@Head 雙向鏈表頭結點
 *				@destval 指定位置的數據域值
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
// 指定位置插入
void DoubleCirLList_DestInsert(DoubleCirLList_t *Head, DataType_t destval, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 定義一個旗幟變數，用於判斷是否找到目標節點
	int flag = 0;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("DestInsert of %d is fail!\n",destval);
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("DestInsert of %d is success!\n", New->data);
		return;
	}

	// 1.遍歷至目標節點
	while (Phead->next != Head->next)
	{
		// 條件判斷找出目標節點
		if (Phead->data == destval)
		{
			flag = 1;
			break;
		}
		Phead = Phead->next;
	}
	//判斷當鏈表中只有一個首節點是不是目標節點
	if(Head->next->data == destval)
	{
		flag = 1;
		Phead = Head->next;
	}
	//判斷尾結點是不是目標節點
	if(Phead->data == destval)
	{
		flag = 1;
	}

	//判斷是否找到目標節點,未找到則不執行插入操作
	if(flag == 0) 
	{
		printf("destval is no find!\n");
		free(New);
		return;
	}
	//找到目標節點執行插入操作
	//2.將新節點next連接至目標節點的直接後繼
	New->next = Phead->next;
	//3.將目標節點的直接後繼的prev連接至新節點
	Phead->next->prev = New;
	//4.將新節點的prev連接至目標節點
	New->prev = Phead;
	//5.將目標節點的next連接至新節點
	Phead->next = New;
	printf("DestInsert of %d is success!\n", New->data);

	return;
}

(5) 根據情況可以從鏈表中刪除某結點，此時可以分為尾部刪除、頭部刪除、指定元素刪除：

頭刪:

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_HeadDel
 *	function :  刪除鏈表的首節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功後刪除鏈表的首節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_HeadDel(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的頭結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	//判斷鏈表是否只有一個首節點
	if(Phead->next == Head)
	{
		Head->next = Head;
		free(Phead);
		return;
	}

	// 1.將尾結點的next連接首節點的直接後繼
	Phead->prev->next= Phead->next;
	// 2.將首節點的直接後繼的prev連接尾結點
	Phead->next->prev = Phead->prev;
	// 3.將首節點的next連接自己
	Phead->next = Phead;
	//4.將頭結點連接至新首節點
	Head->next = Phead->prev->next;
	// 5.將原首節點的prev指向自己
	Phead->prev = Phead;
	//6.釋放掉原首節點
	free(Phead);

	printf("HeadDel is success!\n");

	return;
}

尾刪：

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_tailDel
 *	function :  刪除鏈表的尾節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功後刪除鏈表的尾節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_TailDel(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的首結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;
	// 對雙向迴圈鏈表的尾結點的地址進行備份
	DoubleCirLList_t *Temp = NULL;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}
	//判斷鏈表是否只有一個首節點
	if(Phead->next == Head)
	{
		Head->next = Head;
		free(Phead);
		return;
	}

	//1.將尾結點的直接前驅的next連接至首節點
	Phead->prev->prev->next = Phead;
	//2.對尾結點進行備份
	Temp = Phead->prev;
	//3. 將首節點的prev連接至尾結點的直接前驅
	Phead->prev = Temp->prev;
	//4. 將Temp的prev和next均連接至自己
	Temp->prev = Temp;
	Temp->next = Temp;
	//5.釋放掉Temp
	free(Temp);

	printf("TailDel is success!\n");

	return;
}

指定位置刪：

原理圖示：

代碼實現：

/********************************************************************
 *
 *	name	 :	DoubleCirLList_DestDel
 *	function :  刪除鏈表的指定節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
				@destval 指定位置的數據域值
 *
 *	retval	 :  調用成功後刪除鏈表的尾節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_DestDel(DoubleCirLList_t *Head, DataType_t destval)
{
	// 對雙向迴圈鏈表的首結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;
	// 定義一個旗幟變數用於判斷是否找到目標值
	int flag = 0;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	// 遍歷至目標節點
	while (Phead->next != Head->next)
	{
		// 條件判斷找出目標節點
		if (Phead->data == destval)
		{
			flag = 1;
			break;
		}
		Phead = Phead->next;
	}
	//判斷鏈表中只有一個首節點是不是目標節點
	if(Head->next->data == destval)
	{
		flag = 2;
		Phead = Head->next;
	}
	//判斷鏈表中的尾結點是不是目標節點
	else if( Phead->data == destval)
	{
		flag = 1;
	}

	//判斷是否找到目標節點,未找到則不執行刪除操作
	if(flag == 0) 
	{
		printf("destval of %d is no find!\n",destval);
		return;
	}
	else if(flag == 2) //首節點為目標節點
	{
		//1.將首節點的直接前驅的next連接至首節點的直接後繼
		Phead->prev->next = Phead->next;
		//2.將首節點的直接後繼的prev連接至首節點的直接前驅
		Phead->next->prev = Phead->prev;
		//3.將頭結點的next與首節點的直接後繼相連接
		Head->next = Phead->next;
		//4.將首節點的prev和next均連接至自己
		Phead->next = Phead;
		Phead->prev = Phead;
		//5.釋放掉首節點
		free(Phead);
		return;
	}
	else
	{
		//1.將目標節點的直接前驅的next連接至目標節點的直接後繼
		Phead->prev->next = Phead->next;
		//2.將目標節點的直接後繼的prev連接至目標節點的直接前驅
		Phead->next->prev = Phead->prev;
		//3.將目標節點的prev和next均連接至自己
		Phead->next = Phead;
		Phead->prev = Phead;
		//4.釋放目標節點
		free(Phead);
	}

	printf("DestDel of %d is success!\n",destval);

	return;
}

(6)遍歷輸出鏈表中的所有節點的數據域值

/********************************************************************
 *
 *	name	 :	DoubleCirLList_Print
 *	function :  遍歷輸出雙向迴圈鏈表中所有節點的數據域
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功輸出鏈表中所有節點的數據域的值
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_Print(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的頭結點的地址進行備份
	DoubleCirLList_t *Phead = Head;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == NULL)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	// 從首結點開始遍歷
	while (Phead->next)
	{
		// 把頭結點的直接後繼作為新的頭結點
		Phead = Phead->next;

		// 輸出頭結點的直接後繼的數據域
		printf("%d->", Phead->data);

		// 判斷是否到達尾結點，尾結點的next指針是指向首結點的地址
		if (Phead->next == Head->next)
		{
			break;
		}
	}

	return;
}

代碼完整展示

/*******************************************************************
 *
 *	file name:	DoubleLinkedList.c
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 *	function :  該案例是掌握雙向迴圈鏈表的增刪查改原理
 * 	note	 :  None
 *
 *	CopyRight (c)  2023-2024   [email protected]   All Right Reseverd
 *
 * *****************************************************************/
#include <stdio.h>
#include <stdlib.h>
//指的是雙向迴圈鏈表中的結點有效數據類型，用戶可以根據需要進行修改
typedef int  DataType_t;

//構造雙向迴圈鏈表的結點,鏈表中所有結點的數據類型應該是相同的
typedef struct DoubleCirLinkedList
{
	DataType_t  		     data; //結點的數據域
	struct DoubleCirLinkedList	*prev; //直接前驅的指針域
	struct DoubleCirLinkedList	*next; //直接後繼的指針域

}DoubleCirLList_t;
/********************************************************************
 *
 *	name	 :	DoubleCirLList_Create
 *	function :  創建一個空雙向迴圈鏈表，空鏈表應該有一個頭結點，對鏈表進行初始化
 *	argument :
 *				none
 *
 *	retval	 :  調用成功返回已經完成初始化的雙向迴圈鏈表的頭結點,否則退出程式
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
//創建一個空雙向迴圈鏈表，空鏈表應該有一個頭結點，對鏈表進行初始化
DoubleCirLList_t * DoubleCirLList_Create(void)
{
	//1.創建一個頭結點並對頭結點申請記憶體
	DoubleCirLList_t *Head = (DoubleCirLList_t *)calloc(1,sizeof(DoubleCirLList_t));
	if (NULL == Head)
	{
		perror("Calloc memory for Head is Failed");
		exit(-1); //程式異常退出
	}

	//2.對頭結點進行初始化，頭結點是不存儲數據域，指針域指向自身即可，體現“迴圈”
	Head->prev = Head;
	Head->next = Head;

	//3.把頭結點的地址返回即可
	return Head;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_NewNode
 *	function :  創建新的結點，並對新結點進行初始化（數據域 + 指針域(prev+next)）
 *	argument :
 *				@data 新節點需要存儲的數據
 *
 *	retval	 :  調用成功返回已經完成初始化的雙向鏈表的新節點,否則返回NULL
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
//創建新的結點，並對新結點進行初始化（數據域 + 指針域）
DoubleCirLList_t * DoubleCirLList_NewNode(DataType_t data)
{
	//1.創建一個新結點並對新結點申請記憶體
	DoubleCirLList_t *New = (DoubleCirLList_t *)calloc(1,sizeof(DoubleCirLList_t));
	if (NULL == New)
	{
		perror("Calloc memory for NewNode is Failed");
		return NULL;
	}

	//2.對新結點的數據域和指針域（2個）進行初始化,指針域指向結點自身，體現“迴圈”
	New->data = data;
	New->prev = New;
	New->next = New;

	return New;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_HeadInsert
 *	function :  將新節點頭插進雙向迴圈鏈表中
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/23
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_HeadInsert(DoubleCirLList_t *Head, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("HeadInsert is fail!\n");
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("HeadInsert of %d is success!\n", New->data);
		return;
	}

	// 1.將尾結點的next指向新節點
	Phead->prev->next = New;
	// 2.將新節點的prev指向尾結點
	New->prev = Phead->prev;
	// 3.將新節點的next指向首節點
	New->next = Phead;
	//4.將首節點的prev指向新節點
	Phead->prev = New;
	//5.將頭結點的next指向新節點
	Head->next = New;

	printf("HeadInsert of %d is success!\n", New->data);

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_TailInsert
 *	function :  將新節點尾插進雙向鏈表中
 *	argument :
 *				@Head 雙向鏈表頭結點
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/23
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_TailInsert(DoubleCirLList_t *Head, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("TailInsert is fail!\n");
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("TailInsert of %d is success!\n", New->data);
		return;
	}

	//1.將新節點的prev指向尾結點
	New->prev = Phead->prev;
	//2.將尾結點的next指向新節點
	Phead->prev->next = New;
	//3.將新節點的next指向首節點
	New->next = Phead;
	//4.將首節點的prev指向新節點
	Phead->prev = New;

	printf("TailInsert of %d is success!\n", New->data);

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_DestInsert
 *	function :  將新節點插進雙向迴圈鏈表指定位置中
 *	argument :
 *				@Head 雙向鏈表頭結點
 *				@destval 指定位置的數據域值
 *				@data 新節點的數據域需要存儲的數據
 *
 *	retval	 :  調用成功輸出"插入成功"，否則輸出"插入失敗"
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
// 指定位置插入
void DoubleCirLList_DestInsert(DoubleCirLList_t *Head, DataType_t destval, DataType_t data)
{
	// 定義一個迴圈指針變數Phead
	DoubleCirLList_t *Phead = Head->next;
	// 定義一個旗幟變數，用於判斷是否找到目標節點
	int flag = 0;
	// 調用函數創立一個新節點,並完成對應的錯誤處理
	DoubleCirLList_t *New = DoubleCirLList_NewNode(data);
	if (New == NULL)
	{
		printf("DestInsert of %d is fail!\n",destval);
		return;
	}

	// 進行判斷，排除空鏈表的情況
	if (Head->next == Head)
	{
		Head->next = New;
		printf("DestInsert of %d is success!\n", New->data);
		return;
	}

	// 1.遍歷至目標節點
	while (Phead->next != Head->next)
	{
		// 條件判斷找出目標節點
		if (Phead->data == destval)
		{
			flag = 1;
			break;
		}
		Phead = Phead->next;
	}
	//判斷當鏈表中只有一個首節點是不是目標節點
	if(Head->next->data == destval)
	{
		flag = 1;
		Phead = Head->next;
	}
	//判斷尾結點是不是目標節點
	if(Phead->data == destval)
	{
		flag = 1;
	}

	//判斷是否找到目標節點,未找到則不執行插入操作
	if(flag == 0) 
	{
		printf("destval is no find!\n");
		free(New);
		return;
	}
	//找到目標節點執行插入操作
	//2.將新節點next連接至目標節點的直接後繼
	New->next = Phead->next;
	//3.將目標節點的直接後繼的prev連接至新節點
	Phead->next->prev = New;
	//4.將新節點的prev連接至目標節點
	New->prev = Phead;
	//5.將目標節點的next連接至新節點
	Phead->next = New;
	printf("DestInsert of %d is success!\n", New->data);

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_Print
 *	function :  遍歷輸出雙向迴圈鏈表中所有節點的數據域
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功輸出鏈表中所有節點的數據域的值
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_Print(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的頭結點的地址進行備份
	DoubleCirLList_t *Phead = Head;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == NULL)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	// 從首結點開始遍歷
	while (Phead->next)
	{
		// 把頭結點的直接後繼作為新的頭結點
		Phead = Phead->next;

		// 輸出頭結點的直接後繼的數據域
		printf("%d->", Phead->data);

		// 判斷是否到達尾結點，尾結點的next指針是指向首結點的地址
		if (Phead->next == Head->next)
		{
			break;
		}
	}

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_HeadDel
 *	function :  刪除鏈表的首節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功後刪除鏈表的首節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_HeadDel(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的頭結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	//判斷鏈表是否只有一個首節點
	if(Phead->next == Head)
	{
		Head->next = Head;
		free(Phead);
		return;
	}

	// 1.將尾結點的next連接首節點的直接後繼
	Phead->prev->next= Phead->next;
	// 2.將首節點的直接後繼的prev連接尾結點
	Phead->next->prev = Phead->prev;
	// 3.將首節點的next連接自己
	Phead->next = Phead;
	//4.將頭結點連接至新首節點
	Head->next = Phead->prev->next;
	// 5.將原首節點的prev指向自己
	Phead->prev = Phead;
	//6.釋放掉原首節點
	free(Phead);

	printf("HeadDel is success!\n");

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_tailDel
 *	function :  刪除鏈表的尾節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
 *
 *	retval	 :  調用成功後刪除鏈表的尾節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_TailDel(DoubleCirLList_t *Head)
{
	// 對雙向迴圈鏈表的首結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;
	// 對雙向迴圈鏈表的尾結點的地址進行備份
	DoubleCirLList_t *Temp = NULL;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}
	//判斷鏈表是否只有一個首節點
	if(Phead->next == Head)
	{
		Head->next = Head;
		free(Phead);
		return;
	}

	//1.將尾結點的直接前驅的next連接至首節點
	Phead->prev->prev->next = Phead;
	//2.對尾結點進行備份
	Temp = Phead->prev;
	//3. 將首節點的prev連接至尾結點的直接前驅
	Phead->prev = Temp->prev;
	//4. 將Temp的prev和next均連接至自己
	Temp->prev = Temp;
	Temp->next = Temp;
	//5.釋放掉Temp
	free(Temp);

	printf("TailDel is success!\n");

	return;
}
/********************************************************************
 *
 *	name	 :	DoubleCirLList_DestDel
 *	function :  刪除鏈表的指定節點，並保持鏈表的連續性
 *	argument :
 *				@Head 雙向迴圈鏈表頭結點
				@destval 指定位置的數據域值
 *
 *	retval	 :  調用成功後刪除鏈表的尾節點
 *	author	 :  [email protected]
 *	date	 :  2024/04/24
 * 	note	 :  none
 *
 * *****************************************************************/
void DoubleCirLList_DestDel(DoubleCirLList_t *Head, DataType_t destval)
{
	// 對雙向迴圈鏈表的首結點的地址進行備份
	DoubleCirLList_t *Phead = Head->next;
	// 定義一個旗幟變數用於判斷是否找到目標值
	int flag = 0;

	// 判斷當前鏈表是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return;
	}

	// 遍歷至目標節點
	while (Phead->next != Head->next)
	{
		// 條件判斷找出目標節點
		if (Phead->data == destval)
		{
			flag = 1;
			break;
		}
		Phead = Phead->next;
	}
	//判斷鏈表中只有一個首節點是不是目標節點
	if(Head->next->data == destval)
	{
		flag = 2;
		Phead = Head->next;
	}
	//判斷鏈表中的尾結點是不是目標節點
	else if( Phead->data == destval)
	{
		flag = 1;
	}

	//判斷是否找到目標節點,未找到則不執行刪除操作
	if(flag == 0) 
	{
		printf("destval of %d is no find!\n",destval);
		return;
	}
	else if(flag == 2) //首節點為目標節點
	{
		//1.將首節點的直接前驅的next連接至首節點的直接後繼
		Phead->prev->next = Phead->next;
		//2.將首節點的直接後繼的prev連接至首節點的直接前驅
		Phead->next->prev = Phead->prev;
		//3.將頭結點的next與首節點的直接後繼相連接
		Head->next = Phead->next;
		//4.將首節點的prev和next均連接至自己
		Phead->next = Phead;
		Phead->prev = Phead;
		//5.釋放掉首節點
		free(Phead);
		return;
	}
	else
	{
		//1.將目標節點的直接前驅的next連接至目標節點的直接後繼
		Phead->prev->next = Phead->next;
		//2.將目標節點的直接後繼的prev連接至目標節點的直接前驅
		Phead->next->prev = Phead->prev;
		//3.將目標節點的prev和next均連接至自己
		Phead->next = Phead;
		Phead->prev = Phead;
		//4.釋放目標節點
		free(Phead);
	}

	printf("DestDel of %d is success!\n",destval);

	return;
}
int main(int argc, char const *argv[])
{
	//創建頭結點
	DoubleCirLList_t *Head = DoubleCirLList_Create();

	// 頭插
	DoubleCirLList_HeadInsert(Head, 10);
	DoubleCirLList_HeadInsert(Head, 20);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	// 尾插
	DoubleCirLList_TailInsert(Head, 50);
	DoubleCirLList_TailInsert(Head, 60);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	// 指定位置插
	//1.目標值為首節點時
	DoubleCirLList_DestInsert(Head, 20, 666);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//2.目標值為中間值時
	DoubleCirLList_DestInsert(Head, 50, 888);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//3.目標值為尾節點時
	DoubleCirLList_DestInsert(Head, 60, 999);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//4.當目標值找不到時
	DoubleCirLList_DestInsert(Head, 66, 666);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	// 頭刪
	DoubleCirLList_HeadDel(Head);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	// 尾刪
	DoubleCirLList_TailDel(Head);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	// 指定位置刪
	//刪除此時鏈表首節點
	DoubleCirLList_DestDel(Head, 666);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//刪除此時鏈表的尾結點
	DoubleCirLList_DestDel(Head, 60);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//刪除此時鏈表的中間節點
	DoubleCirLList_DestDel(Head, 50);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");

	//刪除鏈表中不存在值
	DoubleCirLList_DestDel(Head, 666);
	printf("\n");

	// 遍歷顯示
	DoubleCirLList_Print(Head);
	printf("\n");
	return 0;
}

結果驗證：