• 软件工程第四次作业——代码规范


    作业要求:https://edu.cnblogs.com/campus/nenu/SWE2017FALL/homework/993

    结对伙伴:田继平

    一、代码规范原因:

           代码是程序员的面子,《构建之法》第59页写到“软件都是在相互合作中完成的,合作的最小单位是两个人,两个工程师在一起,做的最多的事情就是‘看代码’。每个人都能看别人你的代码,并发表意见。”,第60页写到“计算机只关心编译生成的机器码,你的程序采用哪种缩进风格,变量名有无统一的规范等,与机器码的执行无关”,所以,代码格式最终还是人在看。由此可见,编写出整洁优雅的代码显得尤为重要。

    二、代码规范:

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

      (一)、 代码风格规范

        1、     缩进

          4个空格。

          在Visual Studio 和其他的一些编辑工具中都可以定义Tab键扩展成几个空格键。不用Tab键的原因:Tab键在不同的情况下会显示不同的长度,严重干扰阅      读体验。

        2、     空格

          A、函数名之后不留空格,紧跟左括号“(”。

          B、一元操作符(如“ !”、“ ++”、“ --”)等前后不加空格。

          C、使用if{} else,不要一直用if去判断

        3、     断行

          不把多条语句放在一行上。eg: a = 1;

                        b = 2;

        4、     括号

          A 、对齐。

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

          B、 大括号匹配纵行对齐。

        5、     大小写

          变量、参数:全小写。eg: int name;

        6、     注释

          本次作业代码注释采用“ //…”。

          注释位置:与被描述的代码相邻,上方或右方,不放下方。

          边写代码或改代码边注释,可保证注释与代码的一致。不留多余无用的注释。

      (二)、代码设计规范

        1、if 后面必须加else。

        2、一个函数实现一个功能。

      要求2 :记录完成本周作业过程中,《代码风格规范》执行情况。

        1、缩进

          纠正次数  14次

        2、函数名之后不留空格,紧跟左括号”(“

          纠正次数 4次

        3、像 iffor等关键字之后有空格,再跟左括号“(“

          纠正次数 2次

        4  、使用if{} else,不要一直用if去判断

          纠正次数 2次

        5 、不把多条语句放在一行上

          纠正次数 2次

        6、 在复杂的条件表达式中,用括号清楚的表示逻辑优先级。

           纠正次数 3次

        7、大括号匹配纵行对齐

               纠正次数 5次

        8、变量、参数:全小写。eg: int name

              纠正次数 6次

        9、 注释位置:与被描述的代码相邻,上方或右方,不放下方。

              纠正次数 4次

        10、边写代码或改代码边注释,可保证注释与代码的一致。不留多余无用的注释。

          纠正次数 6次

  • 相关阅读:
    如何制定一周工作计划
    如何评估工作offer(1)
    Iraq shoethrower inspires Web games
    数据加密技术
    数字签名技术原理
    [转载]CSS使用技巧大全
    数字签名介绍
    数字签名原理剖析
    6个有用的MySQL语句
    PGP概述及原理
  • 原文地址:https://www.cnblogs.com/szjzsd/p/7648805.html
Copyright © 2020-2023  润新知