初代发行版本

增加了栈的链表实现方法
编写了markdown文件

STL_Device/STL_Stack.h

@@ -0,0 +1,123 @@
+/*----------------------------------------------------------------------------------------------------
+ #
+ #	Copyright (c) 2022 Yuankang Liang(XerolySkinner)
+ #
+ #	本软件按原样提供,无任何明示或暗示
+ #	在任何情况下,作者都不承担任何损害赔偿责任
+ #
+ #	使用的许可声明:
+ #	1.	不得歪曲本软件的来源,你不能声称你编写了原始软件.
+ #	2.	免费授予以任何目的,前提是版权声明出现在所有副本中.
+ #		并且版权声明和许可声明同时出现.
+ #	3.	你有使用,复制,修改,分发,和销售本软件的许可.
+ #	4.	如果你在产品中使用,产品文档中的声明是赞赏的但不是必须的.
+ #	5.	本通知不得从任何来源删除或更改.
+ #
+ #	Yuankang Liang(XerolySkinner)
+ #		E-mail:zabbcccbbaz@163.com
+ #		QQ:2715099320
+ #		Mobile Phone:13005636215
+ #
+ #	All rights reserved.
+ */
+
+ /**
+  * @file		STL_Stack.h
+  * @brief		实现了STL库中的Stack
+  * @mainpage	主要信息
+  * @author		Yuankang Liang(XerolySkinner)
+  * @email		zabbcccbbaz@163.com
+  * @version		V1.0.0
+  * @date		2022-11-08 16:41
+  */
+
+#ifdef __cplusplus
+#pragma once
+#include "varint.h"
+#include <stdlib.h>
+//////////////////////////////////////////////////////////////////////////////////////////////////////
+//----------------------------------------------------------------------------------------------------
+//	返回值枚举
+//	
+/**
+ * @brief 					栈的返回值
+ */
+enum STACKS_RES{
+	STACKS_OK,				///< 成功
+	STACKS_EMPTY,			///< 栈是空的
+	STACKS_REAL_ERROR,		///< 重分配出错realloc
+	STACKS_MALL_ERROR		///< 重分配出错malloc
+	};
+//////////////////////////////////////////////////////////////////////////////////////////////////////
+//----------------------------------------------------------------------------------------------------
+//	类目
+/**
+ * @brief 					一个栈的类
+ * @note					使用realloc重新分配方式组织
+ *							栈的内存空间的连续的,适合小数据常规速度交换数据
+ */
+class STL_rStack
+{
+	public:
+		STL_rStack(void);
+		~STL_rStack(void);
+	public:
+		u8		push		(u8 var);
+		u8		pop			(void);
+		u8		top			(u8& var);
+		u32		The_size	(void);
+		u32		The_room	(void);
+		u8		clean		(void);
+
+		u8		poptop		(void);
+
+		u8		push32		(u32 var);
+		u32		poptop32	(void);
+
+		void	pushfun(void(*fun)(void));
+		void	(*poptopfun(void))(void);
+	private:
+		u32		room;		//	分配空间
+		u32		size;		//	已有成员
+		u8*		dat;		//	数据头
+};
+//----------------------------------------------------------------------------------------------------
+/**
+ * @brief 					链表方式栈的节点
+ */
+struct _lStack {
+	struct _lStack*	front;		///< 前一个节点的指针
+	void*			dat;		///< 数据的指针
+	u32				size;		///< 该数据的大小
+	};
+typedef struct _lStacks _lStacks;
+/**
+ * @brief 					一个栈的类
+ * @note					使用链表重新分配方式组织
+ *							栈的内存空间是非连续的,适合快速交换数据
+ */
+class STL_lStack{
+	public:
+		STL_lStack(void);
+		~STL_lStack(void);
+	public:
+		u8		push(void* &var, u32 size);
+		u8		pop(void);
+		u8		top(void* &var, u32& size);
+
+		u8		push8(u8 var);
+		u8		top8(u8& var);
+		u8		poptop8(void);
+
+		u8		push32(u32 var);
+		u8		top32(u32& var);
+		u32		poptop32(void);
+
+		u8		pushfun(void(*fun)(void));
+		void	(*poptopfun(void))(void);
+	private:
+		u32			mem;		//	已有成员
+		_lStack*	dat;		//	栈顶成员
+};
+//////////////////////////////////////////////////////////////////////////////////////////////////////
+#endif