C語言資料結構：單向迴圈連結串列的增刪操作

/********************************************************************************************************
*
*
* 設計單向迴圈連結串列的介面
*
* 
*
* Copyright (c)  2023-2024   a1583839363@163.com   All right Reserved
* ******************************************************************************************************/


//指的是單向迴圈連結串列中的結點有效資料型別，使用者可以根據需要進行修改
typedef int  DataType_t;

//構造單向迴圈連結串列的結點,連結串列中所有結點的資料型別應該是相同的
typedef struct CircularLinkedList
{
	DataType_t  		 data; //結點的資料域
	struct LinkedList	*next; //結點的指標域

}CircLList_t;


//建立一個空單向迴圈連結串列，空連結串列應該有一個頭結點，對連結串列進行初始化
CircLList_t * CircLList_Create(void)
{
	//1.建立一個頭結點並對頭結點申請記憶體
	CircLList_t *Head = (CircLList_t *)calloc(1,sizeof(CircLList_t));
	if (NULL == Head)
	{
		perror("Calloc memory for Head is Failed");
		exit(-1);
	}

	//2.對頭結點進行初始化，頭結點是不儲存資料域，指標域指向自身，體現“迴圈”思想
	Head->next = Head;

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

//建立新的結點，並對新結點進行初始化（資料域 + 指標域）
CircLList_t * CircLList_NewNode(DataType_t data)
{
	//1.建立一個新結點並對新結點申請記憶體
	CircLList_t *New = (CircLList_t *)calloc(1,sizeof(CircLList_t));
	if (NULL == New)
	{
		perror("Calloc memory for NewNode is Failed");
		return NULL;
	}

	//2.對新結點的資料域和指標域進行初始化
	New->data = data;
	New->next = NULL;

	return New;
}

//頭插
bool CircLList_HeadInsert(CircLList_t *Head,DataType_t data)
{
	// 1.建立新的結點，並對新結點進行初始化
	CircLList_t *New = CircLList_NewNode(data);
	if (NULL == New)
	{
		printf("can not insert new node\n");
		return false;
	}

	// 2.判斷單向迴圈連結串列是否為空，如果為空，則直接插入即可
	if (Head == Head->next)
	{
		Head->next = New;
        New->next = New;
		return true;
	}

    // 3.如果單向迴圈連結串列為非空，遍歷找到尾結點
    CircLList_t *Last = Head;
    while(Last->next != Head->next)
    {
        Last = Last->next;
    }

	// 4.把新結點插入到連結串列的頭部
	Last->next = New;
    New->next = Head->next;
    Head->next = New;

    return true;
}

//尾插
bool CircLList_TailInsert(CircLList_t *Head,DataType_t data)
{
	// 1.建立新的結點，並對新結點進行初始化
	CircLList_t *New = CircLList_NewNode(data);
	if (NULL == New)
	{
		printf("can not insert new node\n");
		return false;
	}

	// 2.判斷單向迴圈連結串列是否為空，如果為空，則直接插入即可
	if (Head == Head->next)
	{
		Head->next = New;
        New->next = New;
		return true;
	}

    // 3.如果單向迴圈連結串列為非空，遍歷找到尾結點
    CircLList_t *Last = Head;
    while(Last->next != Head->next)
    {
        Last = Last->next;
    }

    // 4.把新結點插入到連結串列的尾部
    Last->next = New;
    New->next = Head->next;

    return true;
}


//指定位置插入
bool CircLList_DestInsert(CircLList_t *Head,DataType_t destval,DataType_t data)
{
	// 1.建立新的結點，並對新結點進行初始化
	CircLList_t *New = CircLList_NewNode(data);
	if (NULL == New)
	{
		printf("can not insert new node\n");
		return false;
	}

	// 2.判斷單向迴圈連結串列是否為空，如果為空，則直接插入即可
	if (Head == Head->next)
	{
		Head->next = New;
        New->next = New;
		return true;
	}

    // 3.遍歷連結串列，比較結點的資料域，找到目標結點
	CircLList_t *Dest = Head->next;
	while (Dest->data != destval && Dest != NULL)
	{
		Dest = Dest->next;
	}
	if (NULL == Dest)
	{
		return false;
	}

	// 4.說明找到目標結點，則把新結點插入到目標結點的後面
	New->next = Dest->next;
	Dest->next = New;

    return true;
}

// 頭刪
bool CircLList_HeadDel(CircLList_t *Head)
{
	// 1.判斷連結串列是否為空，如果為空，則直接退出
	if (Head == Head->next)
	{
		return false;
	}

    // 2.對連結串列的首結點的地址進行備份
	CircLList_t *Temp = Head->next;

	// 3.連結串列是非空的，判斷是否只有首結點
	if(Head->next == Head->next->next)
	{
		Temp->next = NULL;
		Head->next = Head;
		free(Temp);
		return true;
	}

	// 4.遍歷連結串列，找到尾結點
    CircLList_t *Last = Head;
    while(Last->next != Head->next)
    {
        Last = Last->next;
    }

    // 5.刪除首結點
	Last->next = Temp->next;
    Head->next = Temp->next;
	Temp->next = NULL;
	free(Temp);

	return true;
}

// 尾刪
bool CircLList_TailDel(CircLList_t *Head)
{
    // 1.判斷連結串列是否為空，如果為空，則直接退出
	if (Head == Head->next)
	{
		return false;
	}

    // 2.連結串列是非空的，遍歷連結串列，找到尾結點以及尾結點的直接前驅
    CircLList_t *Last_pre = Head;
    CircLList_t *Last = Head->next;
    while(Last->next != Head->next)
    {
        Last = Last->next;
        Last_pre = Last_pre->next;
    }

    // 3.刪除尾結點
    Last_pre->next = Head->next;
    Last->next = NULL;
    free(Last);

	return true;
}

// 指定刪
bool CircLList_DestDel(CircLList_t *Head, DataType_t destval, DataType_t data)
{
    // 1.判斷連結串列是否為空，如果為空，則直接退出
	if (Head == Head->next)
	{
		return false;
	}

    // 2.連結串列是非空的，遍歷連結串列，找到待刪除結點以及待刪除結點的直接前驅
	CircLList_t *Dest_pre = Head;
    CircLList_t *Dest = Head->next;
    while (Dest->data != destval && Dest != NULL)
	{
		Dest = Dest->next;
        Dest_pre = Dest_pre->next;
	}
	if (NULL == Dest)
	{
		return false;
	}

    // 3.刪除指定結點
	Dest_pre->next = Dest->next;
    Dest->next = NULL;
	free(Dest);

	return true;
}

//遍歷連結串列
bool CircLList_Print(CircLList_t *Head)
{
	//對單向迴圈連結串列的頭結點的地址進行備份
	CircLList_t *Phead = Head;
	
	//判斷當前連結串列是否為空，為空則直接退出
	if (Head->next == Head)
	{
		printf("current linkeflist is empty!\n");
		return false;
	}

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

		//輸出頭結點的直接後繼的資料域
		printf("data = %d\n",Phead->data);

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

	return true;
}

int main(int argc, char const *argv[])
{
	
	return 0;
}