目录

编码风格总结

编码风格总结

提示:5月19日学习记录,良好的代码风格

今天对代码风格学习进行了粗略的总结,日后完善

源程序代码的逻辑简明清晰、易读易懂是好程序的一个重要标准,为了做到这一点,应该从以下几个方面遵循相应的规则:

  1. 程序内部的文档
  2. 数据说明
  3. 语句构造
  4. 输入输出
  5. 效率

  1. 标识符

    即符号名,包括模块名、变量名、常量名等。这些名字应能反映它所代表的实际东西,应有一定实际意义。

    ​ 例如,表示次数的量用Times,表示总量的用Total,表示平均值的用Average,表示和的量用Sum等。

    命名规则:
    名字应当选择精炼的、意义明确的名字。
    必要时可使用缩写名字,但这时要注意缩写规则要一致。
    要给每一个名字加注释。
    在一个程序中,一个变量只应用于一种用途。
  2. 注解

    注解决不是可有可无的。

    一些正规的程序文本中,注释行的数量占到整个源程序的1/3到1/2,甚至更多。注解分为序言性注释和功能性注释。

  3. 程序的视觉组织

    代码整体要看着清晰,容易阅读。

相同数据类型的变量放在一个区域并说明

当多个变量名在一个语句中说明时,应该按字母顺序排列这些变量,便于查找。

如果设计时使用了一个复杂的数据结构,则应该用注解说明用程序设计语言实现这个数据结构的方法和特点。

每个语句都应该简单而直接,不能为了提高效率而使程序变得过分复杂;

也不要刻意追求技巧性,使程序编写得过于紧凑。

下述规则有助于使语句简单明了:

不要为了节省空间而把多个语句写在同一行;

尽量避免复杂的条件测试;

尽量减少对“非”条件的测试;

避免大量使用循环嵌套和条件嵌套;

利用括号使逻辑表达式或算术表达式的运算次序清晰直观。

设计和编写程序的输入输出风格规则:

对所有输入数据都进行检验;

检查输入项重要组合的合法性;

保持输入格式简单;

使用数据结束标记,不要要求用户指定数据的数目;

明确提示交互式输入的请求、详细说明可用的选择或边界数值;

当程序设计语言对格式有严格要求时,应保持输入格式一致;

设计良好的输出报表;

给所有输出数据加标志。

程序效率

程序的效率,是指程序的执行速度及程序所需占用的内存和硬盘存储空间。

程序编码,是最后提高运行速度和节省存储的机会了,因此,在此阶段不能不考虑程序的效率。

在把详细设计结果翻译成程序时,总可以应用下述规则:

√ 写程序之前,先简化算术的和逻辑的表达式;

√ 仔细研究嵌套的循环,以确定是否有语句可以从内层往外移;

√ 尽量避免使用多维数组;

√ 尽量避免使用指针和复杂的表;

√ 使用执行时间短的算术运算;

√ 不要混合使用不同的数据类型;

√ 尽量使用整数运算和布尔表达式。

在效率是决定性因素的应用领域,尽量使用有良好优化特性的编译程序,以自动生成高效目标代码。

高效的输入/输出是

操作员能够十分方便、简单地录入输入数据,或者能够十分直观、一目了然地了解输出信息。

关于提高设备输入/输出效率的指导原则:

所有输入输出都应该有缓冲,以减少用于通信的额外开销。

对二级存储器的输入输出应该以信息组为单位进行。

如果“超高效的”输入输出很难被人理解,则不应采用这种方法。