20180925-5 代码规范,结对要求

本次作业要求参见: https://edu.cnblogs.com/campus/nenu/2018fall/homework/2147

 

要求1 《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。

 

比如, 每个函数不超过5行,对于初学者是不切实际的; 大括号匹配纵列对齐,是切实可行的; 变量名易读,是不易检验的,变量名必须是名词短语,遵循熊匈牙利命名法,是易于检验的。 (10分)

 

1. 缩进:定义四个空格为缩进。

2. 大括号匹配:“{”位于函数行末,“}”自成一行并对齐。

3. 空格:添加更多单个空格使代码更加美观,操作符与操作数之间应该用一个空格分开。

4.变量命名:用变量的小写单词命名。为了方便,允许少量的“a”,“b”,“m”,"n",存在,但不超过12个。

5.函数命名:能用比较准确表明函数意义的名字来命名函数。

6.对齐:同一级别代码必须对齐

7.注释:用来解释程序在做什么,注释需要及时更新。

8.函数设计规范:函数功能尽量单一,使用更多的函数。

9.小括号:在复杂的条件表达式中,用括号清楚的表示逻辑优先级。

10.行宽:每行长度不超过30字符

 

要求2 记录完成本周作业过程中,《代码风格规范》执行情况。包括记录每一条规则的违反和纠正、次数,规范中某项条款的增强、消弱、或废除。在编码过程中完全未被违反的条款,说明过于宽松,或你们已经完全"本能"反应,不应作为条款,在本要求及要求1中不得分。此种情况,应补充一条新的条款。 (20分)

 

posted @ 2018-10-08 19:53  潘世维  阅读(99)  评论(0编辑  收藏  举报