C语言数据结构：链式栈及其出入栈

/********************************************************************************************************
 *
 *
 * 实现链式栈一般是以链表作为基础，一般是把链表头部作为栈顶，方便数据的插入和删除，链式栈相当于是一个单向不循环的链表。
 *
 *
 *
 * Copyright (c)  2023-2024   [email protected]   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, DataType_t data)
{
	// 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;
}