结对同学:
要求1
《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。
命名规范
1. 变量名与函数名应尽量使用完整的单词,同时单词应尽可能表明变量或函数的作用。
正确示例:IsOperator 错误示例:gongneng_2
2. 使用Pascal大小写风格命名变量名和函数名
正确示例:IsOperator 错误示例:isOperator
3.对于循环变量或显而易见的变量应使用简单字母作为变量名,不受规则1的约束
正确示例:for(int i=0;;) 错误示例:无
编程风格规范
4.不在同一行命名变量,即一行只声明一个变量
正确示例:
int i;int j;
错误示例
int i;int j;
5. 捕捉异常时进行对用户友好的反馈
正确示例
try { // } catch { throw new Exception("表达式格式不正确!"); }
错误示例
try { // } catch (Exception e) { }
格式规范
6.大括号应单独占一行,并且对应的大括号应在同一列对齐
正确示例
else { // }
错误示例
else { }
7.函数前空两行,一个逻辑模块后空一行
8.使用tab进行缩进,并将缩进宽度设置成四个字符。方法:工具——>选项
9.尽量不使用do-while结构编写代码,增加可读性。
注释规范
10.在顶部对函数或逻辑模块进行注释,表明函数或模块实现的主要功能。注释使用“//”
11.在变量声明的右侧对需要特殊说明的变量进行注释,注释使用“//”
要求2
记录完成本周作业过程中,《代码风格规范》执行情况。包括记录每一条规则的违反和纠正、次数,规范中某项条款的增强、消弱、或废除。在编码过程中完全未被违反的条款,说明过于宽松,或你们已经完全"本能"反应,不应作为条款,在本要求及要求1中不得分。此种情况,应补充一条新的条款。 (20分)
1. 变量名与函数名应尽量使用完整的单词,同时单词应尽可能表明变量或函数的作用。
纠正次数:5次
2. 使用Pascal大小写风格命名变量名和函数名
纠正次数:8次
3.对于循环变量或显而易见的变量可以使用简单字母作为变量名,不受规则1的约束
纠正次数:这一条是在写到for循环的时候增加的,作为对于第一条规范的修正。
4.不在同一行命名变量,即一行只声明一个变量
纠正次数:5次
5. 捕捉异常时进行对用户友好的反馈
纠正次数:1次
6.大括号应单独占一行,并且对应的大括号应在同一列对齐
纠正次数:8次
7.函数前空两行,一个逻辑模块后空一行
纠正次数:20次
8.使用tab进行缩进,并将缩进宽度设置成四个字符。方法:工具——>选项
纠正次数:18次
9.尽量不使用do-while结构编写代码,增加可读性。
纠正次数:2次
10.在顶部对函数或逻辑模块进行注释,表明函数或模块实现的主要功能。注释使用“//”
纠正次数:12次
11.在变量声明的右侧对需要特殊说明的变量进行注释,注释使用“//”
纠正次数:15次