课程设计自查表格
| 序号 | 项目 | 完成与否(完成打勾) |
|---|---|---|
| 1 | 格式是否符合标准（缩进是否规范） | |
| 2 | 是否模块化设计（使用函数分解系统功能） | |
| 3 | 函数名否易懂（不得使用f1(int a1,int a2)这样的函数函数名、入参名,建议使用英文） | |
| 4 | 变量名是否规范（循环中次序变量一般使用i,j,k，计数建议使用count，其他建议使用英文或英文缩写，如avg, sum） | |
| 5 | 每个函数有无注释（包括函数功能、入参说明、返回参数说明） | |
| 6 | 函数名是否规范（建议使用英文） | |
| 7 | 是否滥用全局变量（建议不用） | |
| 8 | 除非你明确知道为什么使用goto语句，且明白goto语句的副作用。否则，不得使用goto语句 | |
| 9 | 有无测试边界条件 |
表格使用说明：
For 老师：课程设计之前就将此表格分发。
For 学生：可以在程序编写完，再对照此表格进行重构。课程设计检查前请先按照此表格进行自查。该表格为基本要求，请务必按照此要求改正。
变量、函数命名建议：
使用驼峰法
void printStudentName(...) //打印学生姓名的函数， int addUser(User* user) //添加学生
avgScore //存放平均分变量，
常用变量名与函数名：
tmp 一般用于临时变量，
i, j, k 作为局部循环变量，不要用x,y,z或者a1,a2,a3作为局部循环变量。
add, sub, mult, div, count, avg, sum
day, month, year
flag 一般用于标志位
max(最大), min(最小)
num用于数字，如numStudents(学生数目)
指针类型变量：
ptr 一般用来代表指针 ，如ptrA
pre 代表指向前一个的指针， next 代表指向下一个指针, cur 当前一个的指针
p, q
常用单词(建议背下来):
search 搜索，get 获取，arr 数组，list 列表, file 文件, str 字符串，
len 长度，arrLen 数组长度，name 名称
add/remove，添加/移除 add/delete，添加/删除 insert/delete，插入/删除
start/stop，开始/停止 begin/end，开始/结束 send/receive，发送/接收
get/set，取出/设置 get/release，获取/释放 put/get，放入/取出
show/hide，显示/隐藏 open/close，打开/关闭
source/target，源/目标 increment/decrement，增加/减少
source/destination，源/目的地 也可以src/dst
create/destroy，创建/销毁， min/max，最小/最大 store/query，存储/查询
结构体首字母应用大写
struct Student{....}
常量名应用大写#define MAX_NUM 10
范例程序
#include <stdio.h>
#include <stdlib.h>
#define YES 1
#define NO -1
#define ERROR -2147483000
#define ARR_LEN 5
/**********************************************************************************
Descriptions: 判断参数value是否在low(包含low)与high(包含high)之间
Input para: value, 所要判断的数值
low， 范围的下界
high, 范围的上界
Return value: YES, 在范围内。NO, 不在范围内
***********************************************************************************/
int isBetween(int value, int low, int high)
{
if(value >= low && value <= high)
return YES;
return NO;
}
/**********************************************************************************
Descriptions: 返回arr数组从下标0到len之间（不包括len）所有在low与high之间的值的和
Input para: arr, 传入数组
len， 数组长度
low, 数值范围下界
high, 数值范围上界
Return value: arr数组从下标0到len之间（不包括len）所有在low与high之间的值的和
***********************************************************************************/
int sumInArray(int arr[], int len, int low, int high)
{
/*注意：每个函数的功能要简单，该函数只负责计算，不负责处理输入输出*/
/*一般函数入口可以判断参数有效性*/
if (low>high )
{
printf("参数无效!参数high必须大于low\n");
return ERROR;
}
if (len<=0)
{
printf("参数无效!参数len必须大于0\n");
return ERROR;
}
int sum = 0;
int i;
for(i = 0; i < len; i++)
{
if (isBetween(arr[i], low, high)==YES)
{
sum += arr[i];
}
}
return sum;
}
/*每个函数的功能尽量简单，此函数只负责显示菜单和返回用户选择的值*/
char mainMenu()
{
char choice;
printf("\t\t*****欢迎进入XX系统*****\n");
printf("\t\t*****1.选择1计算 *****\n");
printf("\t\t*****2.选择2退出 *****\n");
while (1)
{
scanf("%c",&choice);
if (choice<'1' || choice>'2')
printf("\t\t输入错误，重选1-2\n");
else
break;
getchar();//消化输入缓冲区的回车换行符
}
return choice;
}
void calAndDisp(int arr[])
{
int len, low, high;
printf("请输入len、low与high(中间以空格分隔):");
scanf("%d %d %d",&len, &low, &high);
getchar();
int result = sumInArray(arr, len, low, high);
printf("输出结果：数组arr中，所有在%d与%d之间的值的总和为%d\n", low, high, result);
}
int main()
{
int arr[ARR_LEN] = {-1,1,2,3,11};
char choice;
while(1)
{
choice = mainMenu();
switch(choice)
{
case '1':
calAndDisp(arr);
break;
case '2':
printf("退出系统!");
exit(0);
break;
}
}
return 0;
}
评分标准
基本考虑因素：
1.功能是否完整。
2.是否模块化设计？
3.实现难度如何？（如，使用链表实现相对数组实现难，起评分也应提高）。
4.有多少是自己做的？借鉴部分能否看懂代码？
其他考虑因素：
1.有无出错处理。
2.有无特别功能。
3.是否会使用调试技巧解决问题。