顺序栈的接口程序

目录

• 顺序栈的接口程序
  • 头文件
  • 创建顺序栈
  • 入栈
  • 出栈
  • 利用栈将10进制转16进制数
  • 验证

头文件

#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	 :  17647576169@163.com
 *	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	 :  17647576169@163.com
 *	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	 :  17647576169@163.com
 *	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	 :  17647576169@163.com
 *	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	 :  17647576169@163.com
 *	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;
}

利用栈将10进制转16进制数

/********************************************************************
 *
 *	name	 :	SeqStack_Create
 *	function :  10进制转16进制
 *	argument :	@stack：目标栈
 *				@data:	需准换的10进制数
 *	retval	 :  None
 *	author	 :  17647576169@163.com
 *	date	 :  2024-4-25
 * 	note	 :	None
 *
 * *****************************************************************/
void DecToHexadecimal(SeqStack_t *stack, unsigned int data)
{
	int remainder = 0;
	while (data != 0)
	{
		int remainder = data % 16;
		if (remainder < 10)
		{
			SeqStack_Push(stack, remainder + '0');
		}
		else
		{
			SeqStack_Push(stack, remainder + 'A' - 10);
		}
		data /= 16;
	}
}

验证

int main(int argc, char const *argv[])
{
	// 验证顺序栈
	int a = 0;
	// 创建
	SeqStack_t *Manager = SeqStack_Create(6);
	// 入栈
	SeqStack_Push(Manager, 1);
	SeqStack_Push(Manager, 2);
	SeqStack_Push(Manager, 3);
	SeqStack_Push(Manager, 4);
	a = SeqStack_Pop(Manager);
	printf("%d\n", a);
	printf("\n");
	// 出栈
	SeqStack_Print(Manager);
	printf("\n");
	// 入栈
	SeqStack_Push(Manager, 5);
	printf("\n");
	// 出栈
	SeqStack_Print(Manager);
	printf("\n");
	return 0;
}

输出结果

4

Stack Element[0] = 1
Stack Element[1] = 2
Stack Element[2] = 3


Stack Element[0] = 1
Stack Element[1] = 2
Stack Element[2] = 3
Stack Element[3] = 5