顺序栈的接口程序

头文件

#include <stdio.h>
#include <stdbool.h>
#include <stdlib.h>

创建顺序栈

// 指的是顺序栈中的元素的数据类型，用户可以根据需要进行修改
typedef int DataType_t;
// 构造记录顺序栈SequenceStack各项参数(栈底地址+栈容量+栈顶元素的下标)的结构体
typedef struct SequenceStack
{
	DataType_t *Bottom; // 记录栈底地址
	unsigned int Size;	// 记录栈容量
	int Top;			// 记录栈顶元素的下标
} SeqStack_t;
/********************************************************************
 *
 *	name	 :	SeqStack_Create
 *	function :  创建顺序栈并对顺序栈进行初始化
 *	argument :	@size：顺序栈中元素的数量
 *
 *	retval	 :  返回1成功0失败
 *	author	 :  [email protected]
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
SeqStack_t *SeqStack_Create(unsigned int size)
{
	// 1.利用calloc为顺序栈的管理结构体申请一块堆内存
	SeqStack_t *Manager = (SeqStack_t *)calloc(1, sizeof(SeqStack_t));
	if (NULL == Manager)
	{
		perror("calloc memory for manager is failed");
		exit(-1); // 程序异常终止
	}

	// 2.利用calloc为所有元素申请堆内存
	Manager->Bottom = (DataType_t *)calloc(size, sizeof(DataType_t));

	if (NULL == Manager->Bottom)
	{
		perror("calloc memory for Stack is failed");
		free(Manager);
		exit(-1); // 程序异常终止
	}
	// 3.对管理顺序栈的结构体进行初始化（元素容量 + 最后元素下标）
	Manager->Size = size; // 对顺序栈中的容量进行初始化
	Manager->Top = -1;	  // 由于顺序栈为空，则栈顶元素的下标初值为-1
	return Manager;
}
/********************************************************************
 *
 *	name	 :	SeqStack_IsFull
 *	function :  判断顺序栈是否已满
 *	argument :	@Manager：目标栈
 *
 *	retval	 :  返回1为栈满0为栈未满
 *	author	 :  [email protected]
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
bool SeqStack_IsFull(SeqStack_t *Manager)
{
	return (Manager->Top + 1 == Manager->Size) ? true : false;
}
/********************************************************************
 *
 *	name	 :	SeqStack_IsEmpty
 *	function :  判断顺序栈是否为空
 *	argument :	@Manager：目标栈
 *
 *	retval	 :  返回1栈空，返回0栈非空
 *	author	 :  [email protected]
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
bool SeqStack_IsEmpty(SeqStack_t *Manager)
{
	return (-1 == Manager->Top) ? true : false;
}

入栈

把数据插入到栈空间的动作被称为入栈或者压栈

/********************************************************************
 *
 *	name	 :	SeqStack_Push
 *	function :  入栈
 *	argument :	@Manager：目标栈
 *
 *	retval	 :  返回1成功0失败
 *	author	 :  [email protected]
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
bool SeqStack_Push(SeqStack_t *Manager, DataType_t Data)
{
	// 1.判断顺序栈是否已满
	if (SeqStack_IsFull(Manager))
	{
		printf("SeqStack Full is Full!\n");
		return false;
	}

	// 2.如果顺序栈有空闲空间，则把新元素添加到顺序栈的栈顶
	Manager->Bottom[++Manager->Top] = Data;

	return true;
}

出栈

从栈空间中删除数据的动作被称为出栈或者弹栈

/********************************************************************
 *
 *	name	 :	SeqStack_Pop
 *	function :  出栈
 *	argument :	@DataType_t：出栈节点数据值
 *
 *	retval	 :  None
 *	author	 :  [email protected]
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
DataType_t SeqStack_Pop(SeqStack_t *Manager)
{
	DataType_t temp = 0; // 用于存储出栈元素的值

	// 1.判断顺序栈是否为空
	if (SeqStack_IsEmpty(Manager))
	{
		printf("SeqStack is Empty!\n");
		return;
	}

	// 2.由于删除了一个元素，则需要让顺序栈的栈顶元素下标-1
	temp = Manager->Bottom[Manager->Top--];

	return temp;
}