顺序表ADT实现(带注释)

/*
* Created by Dev-c++5.11
* @author: Teresa0312
* @date: 2017-10-05
* @description: 顺序表操作
*/

#include <stdio.h>
#include <stdlib.h>
/*函数状态码*/
#define TRUE 1	//成功
#define OK 1
#define FALSE 0	//失败 
#define ERROR 0	//错误 
#define INFEASIBLE -1	//不可行的
#define OVERFLOW -2 	//溢出

#define LIST_INIT_SIZE	100	//线性表存储空间的初始分配量
#define LISTINCREMENT	10	//线性表存储空间的增量 

typedef int ElemType; //基本数据类型
typedef int Status;	//函数的返回值类型 

/*线性表的动态分配顺序存储结构*/
typedef struct{
	ElemType *elem;	//存储空间基址 
	int length;	//当前长度
	int listsize;	//当前分配的存储容量 以sizeof(ElemType)为单位
}SqList;


//初始化线性表L
Status ListInit(SqList *L){
	L->elem = (ElemType *)malloc(LIST_INIT_SIZE * sizeof(ElemType));		//分配LIST_INIT_SIZE个ElemType的空间
	if (!L->elem){
		exit(OVERFLOW);	//存储分配失败则退出程序
	}
	L->length = 0;		//空表长度为0
	L->listsize = LIST_INIT_SIZE;	//初试存储容量
	return TRUE;
}

//销毁线性表L
Status DestroyList(SqList *L){
	free(L->elem);		//先释放内存
	L->elem = NULL;	//再赋值为NULL
	L->length = 0;		
	L->listsize = 0;	
	return OK;
};

//将L置为空表
Status ClearList(SqList *L){
	L->length = 0;		//置为空表长度为0
	return OK;
}

//若L为空表则返回TRUE 否则返回 FALSE
Status ListEmpty(SqList L){
	if (L.length == 0)
		return TRUE;
	else
		return FALSE;
}

//返回L中数据元素的个数
Status ListLength(SqList L){
	return L.length;
}

//用e返回L中第i个数据元素的值
Status  GetElem(SqList L, int i, ElemType * e){
	if (i <= L.length){		//如果i小于线性表的长度
		*e = *(L.elem + i - 1);	//返回第i个数据元素的值
		return *e;
	}
	else		//否则 返回FALSE
		return FALSE;
}

//返回 L中第一个与e满足关系compare()的数据元素的位序 若不存在 则返回0
Status LocateElem(SqList L, ElemType e, Status (*compare)(ElemType,ElemType)){
	ElemType *p=&e;	
	int i=0;
	while (i <= L.length && !(*compare)(*p,e)){
		//当i小于等于线性表的长度 并且 没有找到与e满足compare()关系的数据元素时 执行循环
		i++;
		p+=sizeof(ElemType);
	}
	if (i < L.length){
		//当i小于线性表的长度时 说明找到了
		return *p;
	}
	else
		return FALSE;	//否则 没有找到

}

//若cur_e是L的数据元素 且不是第一个 则用pre_e返回它的前驱 否则操作失败 pre_e无定义
Status PriorElem(SqList L, ElemType cur_e, ElemType * pre_e){
	ElemType *p=L.elem;
	int i = 1;
	if (*p == cur_e){	//如果是第一个数据元素 则不可行
		printf("它没有前驱 不可行");
		return INFEASIBLE;
	}
	else{
		while (i < L.length && *p != cur_e){
			//从第一个元素开始 与cur_e比较 直至相等或L的最后
			i++;
			p++;
		}
		if (i > L.length)		//没找到 返回INFEASIBLE
			return INFEASIBLE;
		else{
			*pre_e = *(p - 1);		//若找到 将后一个元素赋给pre_e
			return OK;
		}
	}
}

///若cur_e是L的数据元素 且不是最后一个 则用next_e返回它的前驱 否则操作失败 next_e无定义
Status NextElem(SqList L, ElemType cur_e, ElemType * next_e){
	ElemType *p = L.elem;
	int i = 1;
	while (i <= L.length && *p != cur_e){
		//从第一个元素开始 与cur_e比较 直至相等或L的最后
		i++;
		p++;
	}
	if (i >= L.length)		//没找到 返回INFEASIBLE
		return INFEASIBLE;
	else{
		*next_e = *(p + 1);		//若找到 将后一个元素赋给next_e
		return OK;
	}
}

//在L中的第i个位置之前插入新的数据元素e,L的长度加1
Status ListInsert(SqList *L, int i, ElemType e){
	ElemType *newbase, *q, *p;
	if (i <1 || i>L->length + 1)      //判断i是否在顺序表的长度之内          
		return FALSE; 
	if (L->length >= L->listsize)
	{	///如果L.length已经达到或超出设定值，需要扩容 
		newbase = (ElemType *)realloc(L->elem, (L->listsize + LISTINCREMENT) *sizeof(ElemType));
		//重新分配空间 给newbase动态分配一个长度为LISTINCREMENT的新空间d  
		if (!newbase)
			exit(OVERFLOW);	//如果分配失败 返回错误
		L->elem = newbase;      //新基址  
		L->listsize += LISTINCREMENT;  //增加存储容量  
	}
	q = L->elem + i - 1;    //q为插入位置  
	for (p = (*L).elem + (*L).length - 1; p >= q; --p) //插入位置及之后的元素右移 
		*(p + 1) = *p;	//将原来顺序表最后一个位置数据的地址分配给p，然后从后往前依次将数据向后移动一位  
	*q = e; //插入e
	(*L).length++; // 表长增1 
	return OK;
}

//删除L中的第i个元素 并用e返回其值 L的长度减1
Status ListDelete(SqList *L, int i, ElemType * e){
	ElemType *q, *p;
	if (i <1 || i>L->length)		//判断i是否在顺序表的长度之内  
  		return ERROR;
	p = L->elem + L->length - 1;		//p指向最后一个数据元素
	q = L->elem + i - 1;    //q为删除位置  
	for (q; q < p; q++) //删除位置及之后的元素左移 
		*q = *(q + 1);
	--(*L).length; // 表长减1
	return OK;
}

//对L的每一个元素调用函数visit 一旦visit()失败 则操作失败
Status ListTraverse(SqList L, void (*visit)(ElemType *)){
	ElemType *ptr;	//遍历数组
	ptr = L.elem;
	ElemType i = 0;
	for (i = 0; i < L.length; i++)
		visit(ptr + i);		//遍历数组
	printf("\n");
	return OK;
}

//若数据元素a与b相等则返回TRUE 否则返回 FALSE
Status compare(ElemType a, ElemType b){
	if (a == b){
		return TRUE;	
	}
	else
		return FALSE;
}
//输出数据元素
void visit(ElemType *e){
	printf("%c ", *e);
}


int main(){
	SqList a;
	ElemType e;
	int i = 0;
	ListInit(&a);
	printf("顺序表创建成功\n"); 
	for (i = 1; i <=26; i++)
		ListInsert(&a, i,  97+i-1);
	printf("初始化顺序表完成\n"); 
	printf("输出顺序表\n");
	ListTraverse(a, visit);
	printf("输出第3个元素的前驱");
	PriorElem(a, 'c', &e);
	printf("%c\n",e);
	printf("输出第3个元素的后继");
	NextElem(a, 'c', &e);
	printf("%c\n",e);
	printf("输出与t相等的元素");
	printf("%d\n",LocateElem(a,'t',compare));
	if(ListDelete(&a,6,&e))
	printf("删除%c成功\n",'a'+6-1); 
	printf("输出顺序表\n");
	ListTraverse(a, visit);
}