C語言資料結構：鏈式棧及其出入棧

/********************************************************************************************************
 *
 *
 * 實現鏈式棧一般是以連結串列作為基礎，一般是把連結串列頭部作為棧頂，方便資料的插入和刪除，鏈式棧相當於是一個單向不迴圈的連結串列。
 *
 *
 *
 * Copyright (c)  2023-2024   a1583839363@163.com   All right Reserved
 * ******************************************************************************************************/

// 指的是鏈式棧中的結點有效資料型別，使用者可以根據需要進行修改
typedef int DataType_t;

// 構造鏈式棧的結點,連結串列中所有結點的資料型別應該是相同的
typedef struct LinkedStack
{
	DataType_t data;		 // 結點的資料域
	struct LinkedStack *next; // 結點的指標域

}LStack_t;

// 建立一個空的鏈式棧，其中應該有一個頭結點，對鏈式棧進行初始化
LStack_t *LStack_Create(void)
{
	// 1.建立一個頭結點並對頭結點申請記憶體
	LStack_t *Head = (LStack_t *)calloc(1, sizeof(LStack_t));
	if (NULL == Head)
	{
		perror("Calloc memory for Head is Failed");
		exit(-1);
	}

	// 2.對頭結點進行初始化，頭結點是不儲存有效內容的！！！
	Head->next = NULL;

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

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

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

	return New;
}

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

	// 2.判斷鏈式棧是否為空，如果為空，則直接插入即可
	if (NULL == Head->next)
	{
		Head->next = New;
		return true;
	}

	// 3.如果鏈式棧為非空，則把新結點插入到鏈式棧的頭部
	New->next = Head->next;
	Head->next = New;

	return true;
}

// 出棧
bool LStack_Pop(LStack_t *Head)
{
	// 1.對鏈式棧的首結點的地址進行備份
	LStack_t *Temp = Head->next;
	// 2.判斷連結串列是否為空，如果為空，則直接退出
	if (NULL == Head->next)
	{
		return false;
	}
	// 3.連結串列是非空的，則直接刪除首結點
	Head->next = Temp->next;
	Temp->next = NULL;
	free(Temp);

	return true;
}

// 遍歷
void LStack_Print(LStack_t *Head)
{
	// 對連結串列的標頭檔案的地址進行備份
	LStack_t *Phead = Head;

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

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

int main(int argc, char const *argv[])
{

	return 0;
}