作业要求20180925-5 代码规范,结对要求
此作业要求参见:https://edu.cnblogs.com/campus/nenu/2018fall/homework/2147
代码地址https://git.coding.net/liuyy0817/f4.git
要求1 《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。
比如, 每个函数不超过5行,对于初学者是不切实际的; 大括号匹配纵列对齐,是切实可行的; 变量名易读,是不易检验的,变量名必须是名词短语,遵循熊匈牙利命名法,是易于检验的。 (10分)
要求2 记录完成本周作业过程中,《代码风格规范》执行情况。包括记录每一条规则的违反和纠正、次数,规范中某项条款的增强、消弱、或废除。在编码过程中完全未被违反的条款,说明过于宽松,或你们已经完全"本能"反应,不应作为条款,在本要求及要求1中不得分。此种情况,应补充一条新的条款。 (20分)
(一)缩进:使用空四格
(二)括号:在复杂的条件表达式中,用括号清楚的表示逻辑优先级
(三)断行与空白的{}行:每个“{”和“}”都独占一行
(四)分行:不要把多条语句放在一行上
(五)命名:
(1)变量命名:采用匈牙利命名法
(2)函数命名:使用较为准确表明函数意义的函数名
(六)下划线:用来分隔变量名字中的作用域标注和变量的语义
(七)大小写:使用Pascal命名法
(八)注释
(1)函数注释:使用较为准确表明函数意义的注释
(2)不使用中文或其他无意义的字符
规范项 | 违反次数 | 改正次数 | 举例 | 增强、消弱、或废除 |
(一) | 5 | 5 | 使用Tab键进行缩进 | 无 |
(二) | 3 | 3 | 没有加入括号导致运算错误 | 无 |
(三) | 6 | 6 | “}”没有独自占用一行 | 无 |
(四) | 4 | 4 | 在同一行初始化多个变量 | 无 |
(五) (1) | 8 | 8 | 未采用匈牙利命名法,仅使用汉语拼音进行变量的命名 | 无 |
(五) (2) | 5 | 5 | 函数名命名时未采用具有具体意义的名字,使用简单的a b c进行函数命名 | 无 |
(六) | 0 | 0 | 在整个过程中未使用下划线 | 削弱 |
(七) | 13 | 13 | 在对变量和函数进行命名时未采用Pascal命名法 | 无 |
(八) (1) | 5 | 5 | 对于函数的注释仅用代码标注了整个代码过程中的函数的位置 | 无 |
(八) (2) | 6 | 6 | 使用中文进行代码注释的标注 | 无 |