双向链表接口设计

/**

* @file name: 双向链表接口设计（非循环接口）

* @brief

* @author [email protected]

* @date 2024/04/23

* @version 1.0 ：

* @property ：

* @note

* CopyRight (c) 2023-2024 [email protected] All Right Reseverd

*/

构造双向循环链表结构体

// 指的是双向链表中的结点有效数据类型，用户可以根据需要进行修改
typedef int DataType_t;
// 构造双向链表的结点,链表中所有结点的数据类型应该是相同的
typedef struct DoubleLinkedList
{
	DataType_t data;			   // 结点的数据域
	struct DoubleLinkedList *prev; // 直接前驱的指针域
	struct DoubleLinkedList *next; // 直接后继的指针域
} DoubleLList_t;

创建一个空双向链表并初始化

DoubleLList_t *DoubleLList_Create()
{
	// 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;
}

功能函数：从首节点进行插入元素

bool DoubleLList_HeadInsert(DoubleLList_t *Head, DataType_t data)
{
	DoubleLList_t *new = DoubleLList_NewNode(data);
	DoubleLList_t *tmp = Head->next;
	if (Head->next == NULL) // empty list 链表为空的情况
	{
		Head->next = new;
		return true;
	}
	new->next = Head->next; // normal situation 普通情况
	Head->next->prev = new;
	Head->next = new;
	return true;
}

功能函数：从尾部插入新元素

bool DoubleLList_TailInsert(DoubleLList_t *Head, DataType_t data)
{
	DoubleLList_t *new = DoubleLList_NewNode(data);
	DoubleLList_t *tmp = Head->next;
	if (Head->next == NULL) // judge is the null 链表为空的情况
	{
		Head->next = new;
		return true;
	}
	while (tmp->next != NULL) // as the normal situation,find the last node 普通情况，遍历寻找最后的节点
		tmp = tmp->next;
	tmp->next = new; // 在尾部插入节点
	new->prev = tmp;
	return true;
}

功能函数：从指定位置插入新元素

bool DoubleLList_DestInsert(DoubleLList_t *Head, DataType_t destval, DataType_t data)
{
	DoubleLList_t *tmp = Head->next;
	DataType_t i = Head->data;
	if (Head->next == NULL) // judge the empty list 链表为空的情况
	{
		printf("The list is empty,there is no destival.\n");
		return false;
	}
	DoubleLList_t *new = DoubleLList_NewNode(data);
	while (destval != tmp->data && tmp->next != NULL)
	// as the normal situation,find the destval找到目标值
	{
		tmp = tmp->next;
	}
	if (destval == tmp->data) // 如果存在目标值，则进行插入操作
	{
		new->next = tmp->next;
		tmp->next->prev = new;
		new->prev = tmp;
		tmp->next = new;
		return true;
	}
	else // 如果不存在目标值，则插入无效，直接返回
	{
		printf("There is no destval\n");
		return false;
	}
}

功能函数：删除首节点

bool DoubleLList_HeadDel(DoubleLList_t *Head)
{
	// 对链表的首结点的地址进行备份
	DoubleLList_t *Phead = Head->next;
	// DoubleLList_t *tmp = Head->next;
	if (Head->next == NULL) // 判断当前链表是否为空，为空则直接退出
	{
		printf("current linkeflist is empty!\n");
		return false;
	}
	Head->next = Phead->next; // delete the head 直接进行删除首节点操作
	Phead->next = NULL;
	Phead->prev = NULL;
	Head->next->prev = NULL;
	free(Phead);
	return true;
}

功能函数：删除尾部节点

bool DoubleLList_TailDel(DoubleLList_t *Head)
{
	DoubleLList_t *tmp = Head->next;
	if (Head->next == NULL) // 判断当前链表是否为空，为空则直接退出
	{
		printf("current linkeflist is empty!\n");
		return false;
	}
	while (tmp->next != NULL) // find the last node 普通情况，遍历寻找最后的节点
	{
		tmp = tmp->next;
	}
	tmp->prev->next = NULL; // 此处应考虑，是否需要增加一个变量记录目标值直接前驱
	tmp->prev = NULL;
	tmp->next = NULL;
	free(tmp);
	return true;
}

功能函数：删除指定位置的节点

bool DoubleLList_MidDel(DoubleLList_t *Head, DataType_t destval)
{
	DoubleLList_t *tmp = Head->next;
	if (Head->next == NULL) // 判断当前链表是否为空，为空则直接退出
	{
		printf("current linkeflist is empty!\n");
		return false;
	}
	while (tmp->data != destval && tmp->next != NULL) // find the specific node找到指定值的节点
	{
		tmp = tmp->next;
	}
	if (tmp->data == destval && tmp == Head->next)
	{
		Head->next = tmp->next; // 如果存在目标值，且目标值位于首节点时，进行头删操作
		Head->next->prev = NULL;
		tmp->next = NULL;
		tmp->prev = NULL;
		free(tmp);
		return true;
	}
	else if (tmp->data == destval) // 如果存在目标值，且目标值不位于首节点时，进行删除操作
	{
		tmp->prev->next = tmp->next;
		tmp->next->prev = tmp->prev;
		tmp->prev = NULL;
		tmp->next = NULL;
		free(tmp);
		return true;
	}
	else // 如果不存在目标值，则直接返回
	{
		printf("The is no destival\n");
		return false;
	}
}

功能函数：遍历打印链表

bool DoubleLList_Print(DoubleLList_t *Head)
{
	// 对链表头结点的地址进行备份
	DoubleLList_t *Phead = Head;
	// 判断当前链表是否为空，为空则直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return false;
	}
	// 从首结点开始遍历
	while (Phead->next)
	{
		// 把头结点的直接后继作为新的头结点
		Phead = Phead->next;
		// 输出头结点的直接后继的数据域
		printf("data = %d  ", Phead->data);
		// 判断是否到达尾结点，尾结点的next指针是指向首结点的地址
		if (Phead->next == Head->next)
		{
			break;
		}
	}
	return true;
}

主函数，调用并测试各功能函数

int main(int argc, char const *argv[])
{
	DoubleLList_t *H = DoubleLList_Create();
	DoubleLList_HeadInsert(H, 20);
	DoubleLList_HeadInsert(H, 30);
	//DoubleLList_HeadInsert(H, 10);
	DoubleLList_TailInsert(H, 40);
	DoubleLList_TailInsert(H, 20);
	DoubleLList_TailInsert(H, 50);
	DoubleLList_DestInsert(H, 30, 31);
	DoubleLList_DestInsert(H, 32, 31);

	DoubleLList_Print(H);
	puts("");
	DoubleLList_HeadDel(H);
	printf("1\n");
	DoubleLList_TailDel(H);
	printf("2\n");
	DoubleLList_MidDel(H, 31);
	printf("3\n");

	DoubleLList_Print(H);
	puts("");
	return 0;
}