c语言中集体注释,C语言实现List的数据结构(很详细的注释)

#include

#include //动态分配内存

#include //exit 函数

#include //布尔值函数

struct Arr

{

int *pBase;//存储的是数组第一个元素的地址

int len;//数组能容纳的最大元素的个数

int cnt;//有效数组个数

//自动增长因子

};

void show_arr(struct Arr *pArr);//显示,分号不能省

void init_arr(struct Arr *pArr, int length);//初始化数组

bool is_empty(struct Arr *pArr);//判断是否为空数组

bool append_arr(struct Arr *pArr, int val);//追加，可能成功，可能失败

bool is_full(struct Arr *pArr);//是否满了

bool delete_arr(struct Arr *pArr, int pos, int *pVal);//删除某个元素

bool insert_arr(struct Arr *pArr, int pos, int val); // 插入一条数据 pos的值从1开始

void sort_arr(struct Arr *pArr);//排序

void innversion_arr(struct Arr *pArr);//倒置

int main(void)

{

printf("%s\n", "start");

struct Arr arr;

init_arr(&arr,6);

append_arr(&arr, 1);

append_arr(&arr, 21);

append_arr(&arr, 3);

append_arr(&arr, 4);

insert_arr(&arr,5,6);

append_arr(&arr, 5);

int val;

int posi = 2;

/** 删除其中一个元素 **/

/* if (delete_arr(&arr, posi, &val)) { printf("删除成功元素为"); printf("%d\n",val); } else { printf("%s\n""删除失败"); } */

sort_arr(&arr);

innversion_arr(&arr);

show_arr(&arr);

/*int len; printf("%s\n","please input 请输入你需要分配的数组长度：len="); scanf("%d",&len); //(int?*)为强制转换，强制使pArr指向前四个字节。 int *pArr = (int *)malloc(sizeof(int)*len);*/

printf("%s\n", "end");

getchar();

return 0;

}

void innversion_arr(struct Arr *pArr)//倒置

{

int i = 0;

int j = pArr->cnt - 1;

int t;

while (i

{

t = pArr->pBase[i];

pArr->pBase[i] = pArr->pBase[j];

pArr->pBase[j] = t;

++i;

--j;

}

return;

}

void sort_arr(struct Arr *pArr)//排序,冒泡排序，比较相邻的2个元素大小，再替换位置

{

int i, j, t;

for (i = 0; i < pArr->cnt; ++i)

{

for (j = i + 1; j < pArr->cnt; ++j)

{

if (pArr->pBase[i] > pArr->pBase[j])

{

t = pArr->pBase[i];

pArr->pBase[i] = pArr->pBase[j];

pArr->pBase[j] = t;

}

}

}

}

bool insert_arr(struct Arr *pArr, int pos, int val) { //pos的值从1开始

int i;

if (is_full(pArr))

return false;

if (pos<1 || pos>pArr->cnt + 1) //判断要插入的位置是否小于1 或者大于有效数组个数加一的(就是不连续的插入位置) 返回false

return false;

for (i = pArr->cnt - 1; i >= pos - 1; --i)//插入数据时从最后一个开始到pos-1数组的位置向后面移动一个位置

{

pArr->pBase[i + 1] = pArr->pBase[i];//pos位置之后的向后移动一个位置

}

pArr->pBase[pos - 1] = val; //插入新增的数据

(pArr->cnt)++; //有效个数加一

}

bool delete_arr(struct Arr *pArr, int pos, int *pVal) {

int i;

if (is_empty(pArr))

return false;//指针为空

if (pos<1 || pos > pArr->cnt)

return false;//没有这个位置

*pVal = pArr->pBase[pos - 1];//赋值给pVal

for (i = pos; icnt; ++i)

{

pArr->pBase[i - 1] = pArr->pBase[i];//pos位置之后的向前移动一个位置

}

(pArr->cnt)--; //删除一个元素后有效个数减去一个

return true;

}

bool append_arr(struct Arr *pArr, int val)//追加，可能成功，可能失败

{

//满时返回false

if (is_full(pArr))

return false;

//不满时追加

pArr->pBase[pArr->cnt] = val;

(pArr->cnt)++;

return true;

}

bool is_full(struct Arr *pArr)//是否满了

{

if (pArr->cnt == pArr->len) {

printf("%s\n", "当前分配的数组长度已满");

return true;

}

else

{

return false;

}

}

void show_arr(struct Arr *pArr)//显示

{

// if(数组为空)

// 提示用户数组为空

// else

// 输出数组有效内容

if (is_empty(pArr)) //

{

printf("数组为空!\n");

}

else

{

for (int i = 0; icnt; i++)

printf("%d\n", pArr->pBase[i]);

printf("\n");

}

}

bool is_empty(struct Arr *pArr)//是否为空

{

if (0 == pArr->cnt)

return true;

else

return false;

}

void init_arr(struct Arr *pArr, int length) {

//分配初始化数组

pArr->pBase = (int*)malloc(sizeof(int)*length);

if (NULL == pArr->pBase)

{

printf("free error 动态内存分配失败！\n");

exit(-1);//终止整个程序

}

else

{

pArr->len = length;

pArr->cnt = 0;

printf("free 动态内存分配成功！\n");

}

return;

}