• 代码规范,结对要求


    结对同学:代秋彤

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

    我们目前制定的代码规范分为三部分:版式要求,注释要求,命名规则。

    具体条款如下:

    一. 版式要求:

    1. 尽量使用标准库函数和公共函数。
    2. 每个函数都有函数头说明。
    3. 利用缩进来显示程序的逻辑结构,缩进量一致并以Tab键为单位。
    4. 每个函数定义结束后加空行。
    5. 关键字后要加空格,如“if”后应留空格再加左括号;函数名后要紧跟左括号,与关键字进行区别。
    6. If、for、while、do等语句自占一行。
    7. 一行代码只做一件事情,如只定一个变量或只写一条语句。
    8. 程序中“{”和“}”应独占一行并且位于同一列。
    9.  “{ }”之内的代码块在“{”右边数格处左对齐。

     二. 注释要求:

    1. 注释要简洁明了,注释的花样要少。
    2. 注释可以与语句在同一行,也可以在上行。
    3. 边写代码边注释,修改代码同时修改相应的注释,保证注释与代码的一致性。
    4. 主要变量(结构、联合、类或对象)定义或引用时,注释能反映其含义。

     三. 命名规则:

    1. 变量和参数用大写字母开头的单词组合而成。
    2. 常量全用大写的字母,用下划线分割单词。

    执行和违反情况

    1.通过调整做到缩进标准,逻辑结构清晰:

    2.修改后保证空行正确:

    3.修改后做到关键字后加空格,函数名后要紧跟左括号,与关键字进行区别:

    4.修改后做到If、for、while、do等语句自占一行:

    5.修改后保证一行代码只做一件事情

    6.修改后保证程序中“{”和“}”独占一行并且位于同一列,且“{ }”之内的代码块在“{”右边数格处左对齐:

    7.注释部分经过修改达到全部4点要求,做到简洁易懂:

    8.命名遵循规范,详情见代码。

  • 相关阅读:
    day01-html
    Word中划线的方法(五种)
    关于获取请求参数并处理显示的总结
    确定目标,把握时间,创造机会,努力加油!(关于大三下学期人生规划浅谈)
    重载运算符(一个例子)
    关于连接数据库的那点总结(感觉挺好的)
    Ribbon负载均衡
    idea中一份代码模拟集群
    Eureka集群
    Eureka配置服务提供者、服务消费者、失效剔除和自我保护
  • 原文地址:https://www.cnblogs.com/rensijia/p/7634579.html
Copyright © 2020-2023  润新知