码迷,mamicode.com
首页 > 其他好文 > 详细

结对编程作业

时间:2018-04-06 20:23:29      阅读:210      评论:0      收藏:0      [点我收藏+]

标签:ble   ted   class   优先   header   数学   false   完成   tab   

1. 题目要求

(1). 首先在同学中找一个同伴,范围不限,可以在1~5班中随意组合,建议尽量不要找同组的成员,女同学尽量找男同学结对,但是不做强制要求;
(2). 从以往个人完成的项目中选择一个作品,例如:以往的数据结构课程设计或者其它具有比较完整功能的小系统,代码至少要大于100行;
(3). 将代码上传至个人GitHub或Coding.net系统中,并将代码地址交给对方;
(4). 对同伴的作品进行代码复审,并参照C/C++代码审查表和 Java代码审查表 这两篇博文的内容自行设计代码审查表并填写内容;
(5). 将对伙伴审查的结果以表格的形式写到自己的博客作业里,博客中应该附有伙伴作业的GitHub或Coding.net的代码地址;
(6). 对同伴的代码写一篇500字以上的评论,介绍同伴的优缺点。

代码链接:https://github.com/vbngfh123456/ruangon4/blob/master/LICENSE.md/code.cpp

2. 代码复审

功能模块名称
审查人 张天齐 审查日期 20180406
代码名称 哈希表 代码作者 冯玉正
文件结构
重要性 审查项 结论
头文件和定义文件的名称是否合理?
头文件和定义文件的目录结构是否合理?
版权和版本声明是否完整?
重要 头文件是否使用了 ifndef/define/endif 预处理块?  
头文件中是否只存放“声明”而不存放“定义”
程序的版式
重要性 审查项 结论
空行是否得体?  
  代码行内的空格是否得体?  
长行拆分是否得体?  
“{” 和 “}” 是否各占一行并且对齐于同一列?  
重要 一行代码是否只做一件事?如只定义一个变量,只写一条语句。  
重要 If、for、while、do等语句自占一行,不论执行语句多少都要加 “{}”。
重要 在定义变量(或参数)时,是否将修饰符 * 和 & 紧靠变量名?注释是否清晰并且必要?  
重要 注释是否有错误或者可能导致误解?  
重要 类结构的public, protected, private顺序是否在所有的程序中保持一致?
命名规则
重要性 审查项 结论
重要 命名规则是否与所采用的操作系统或开发工具的风格保持一致?  
  标识符是否直观且可以拼读?  
  标识符的长度应当符合“min-length && max-information”原则?  
重要 程序中是否出现相同的局部变量和全部变量?  
  类名、函数名、变量和参数、常量的书写格式是否遵循一定的规则?  
静态变量、全局变量、类的成员变量是否加前缀?
表达式与基本语句
重要性 审查项 结论
重要 如果代码行中的运算符比较多,是否已经用括号清楚地确定表达式的操作顺序?  
  是否编写太复杂或者多用途的复合表达式?  
重要 是否将复合表达式与“真正的数学表达式”混淆?
重要 是否用隐含错误的方式写if语句? 例如  
  (1)将布尔变量直接与TRUE、FALSE或者1、0进行比较。  
  (2)将浮点变量用“==”或“!=”与任何数字比较。  
  (3)将指针变量用“==”或“!=”与NULL比较。
  如果循环体内存在逻辑判断,并且循环次数很大,是否已经将逻辑判  
  断移到循环体的外面?    
重要 Case语句的结尾是否忘了加break?  
重要 是否忘记写switch的default分支?  
重要 使用goto 语句时是否留下隐患? 例如跳过了某些对象的构造、变量的初始化、重要的计算等。
函数设计
重要性 审查项 结论
  参数的书写是否完整?不要贪图省事只写参数的类型而省略参数名字。  
  参数命名、顺序是否合理?  
  参数的个数是否太多?  
  是否使用类型和数目不确定的参数?  
  是否省略了函数返回值的类型?  
  函数名字与返回值类型在语义上是否冲突?  
重要 是否将正常值和错误标志混在一起返回?正常值应当用输出参数获得,而错误标志用return语句返回。  
重要 在函数体的“入口处”,是否用assert对参数的有效性进行检查?  
重要 使用滥用了assert? 例如混淆非法情况与错误情况,后者是必然存在的并且是一定要作出处理的。  
重要 return语句是否返回指向“栈内存”的“指针”或者“引用”?  
  是否使用const提高函数的健壮性?const可以强制保护函数的参数、返回值,甚至函数的定义体。“Use const whenever you need”
其它常见问题
重要性 审查项 结论
重要 数据类型问题:  
  (1)变量的数据类型有错误吗?  
  (2)存在不同数据类型的赋值吗?  
  (3)存在不同数据类型的比较吗?  
重要 变量值问题:  
  (1)变量的初始化或缺省值有错误吗?  
  (2)变量发生上溢或下溢吗?  
  (3)变量的精度够吗?  
重要 逻辑判断问题:  
(1)由于精度原因导致比较无效吗?  
  (2)表达式中的优先级有误吗?    
  (3)逻辑判断结果颠倒吗?    
重要 循环问题:  
  (1)循环终止条件不正确吗?   
  (2)无法正常终止(死循环)吗?   
  (3)错误地修改循环变量吗?    
  (4)存在误差累积吗?   
重要 错误处理问题:  
  (1)忘记进行错误处理吗?    
  (2)错误处理程序块一直没有机会被运行?    
  (3)错误处理程序块本身就有毛病吗?如报告的错误与实际错误不一致,处理方式不正确等等。   
  (4)错误处理程序块是“马后炮”吗?如在被它被调用之前软件已经出错。    
重要 文件I/O问题:  
  (1)对不存在的或者错误的文件进行操作吗?    
  (2)文件以不正确的方式打开吗?    
  (3)文件结束判断不正确吗?    
  (4)没有正确地关闭文件吗?  

3. 评价

??冯同学同学的这篇哈希表代码需要改进的地方还是有的。就代码实际内容讲,冗余代码较多,并且多数函数类型和返回值的定义没有用到,那么定义出这个类型就失去了意义。
整篇代码未涉及异常处理,稳定性较差,完全可以根据定义出的函数类型做出相应的异常处理。可能处于代码完成时间较早,当时对于写代码的思想还是依赖于自己的习惯,这里希望冯同学可以做小笔记了。
??前面也讲了代码完成时间较早,所以著作权版权声明没有是意料之中的,代码是有自己创造出来的一笔智慧财富,没有版权声明泼到网上就跟你一点关系也没有,冯同学可以增强一下个人权益意识,就想来是讲的万一以后被人拿去用,也是能够看得出这是你的一份功劳的。再者关键地方注释太过简洁,可能现在自己也看不太懂了(我看着是挺费劲)。
??由于是第一次复审,效率感觉很低,首先通读一遍代码想要理解代码逻辑真的很难,让我意识到注释的重要性。这次就是看一遍代码找一点缺点记下来,再看一遍......冯同学的代码里所存在的问题我的代码里肯定顶也有不少,知道自己问题所在肯定也是要改的,冯同学咱们一起进步吧(一起鸡蛋里面挑骨头)。

结对编程作业

标签:ble   ted   class   优先   header   数学   false   完成   tab   

原文地址:https://www.cnblogs.com/fashow/p/8728128.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!