汇编程序员之代码风格指南

Style Guidelines for Assembly Language Programmers
汇编程序员之代码风格指南


作者：Randall Hyde
  http://webster.cs.ucr.edu/  
译者：jhkdiy
        http://jhkdiy.icpcn.com     or  http://www.20cn.net    
e-mail:[email protected]
译期：开始于06年7月4号。结束于8月31日
原文总页数：42页。译文总页数：60页。
   

    大家知道这位作者吗？不知道？晕••••。那看过《The Art of Assembly Language》一书吗？该书的作者就是Randall Hyde。
这本书在国外有很高的评价，以至于国内也有了翻译的版本：《汇编语言编程艺术》。由陈曙晖翻译，我买了但还没看^_^!。这份代码风格指南是我在作者主页里找到的，有空就去浏缆一下吧，或许有意外收获哦！
    在这漫长的翻译旅途中，自己也是一边翻译一边学习该文档的。翻译完后觉得要写出一个易读的程序其实并不容易，但也不是很难，只要自己坚持遵循该文档的话就可以尽能地做到程序易读了。自己学习汇编语言也有一段时间了，却很少在网上的论坛见到过非常易读的汇编程序，绝大一部分是没有任何注释、带有一大堆a、b、d等变量名的难读程序，有一次看到有人特意将整个C语言源代码改成像文字画一样我就跟他吵了起来。无论是汇编也好、C语言或其它语言也好，很多编程的朋友都不把代码的易读性放在眼里，有的甚至从来不考虑，只要代码能执行起来，程序运行起来就算完事了。更有的程序员为编写难读的代码而自我臭美。而大学里教授编程语言的时候，很少有老师对程序的易读性做过教导或建议，以至于学生们从一开始便没有编写易读代码的意识，这在一定程度上增加了编写难读程序的人员。代码是拿来读的，为了能更快更容易地阅读代码，我们必定要遵循一定的规则。
    我真心希望越来越多的朋友能写出可读性好的代码，就算将代码发表到全世界，只要学过该语言的人都能看懂中国人编写的程序，因为它深具可读性，读代码像读诗篇一样流畅而自然。希望这一天早日到来！
                                              jhkdiy
                                                  2006-8-31


《汇编程序员之代码风格指南》

目录：

1.0简介

          1.1 ADDHEX.ASM

          1.2 Graphics Example

          1.3 S.COM 例子

          1.4本文面向的读者

          1.5可读性标准

          1.6怎样做到可读性

          1.7这份文档的组织

          1.8指导、 规则、强制性规则、和例外

          1.9 涉及的语言

2.0程序组织

              2.1库函数

              2.2公共目标模块

              2.3局部模块

              2.4程序的make文件

3.0 模块组织

              3.1模块属性

              3.1.1模块内聚性

              3.1.2模块耦合性

              3.1.3模块的物理组织

              3.1.4模块接口

4.0程序单元组织

              4.1例程内聚性

                            4.1.1例程耦合性

                            4.1.2例程大小

              4.2主过程和数据的安排

5.0语句组织

6.0注释

              6.1什么是一个坏注释？

              6.2什么是一个好注释？

              6.3行终止注释VS独立注释

              6.4未完成的代码

              6.5代码交叉参考到其它文档

7.0名称、指令、操作数和操作                   

        7.1名称

                            7.1.1命名约定

                            7.1.2字母大小写考虑

                            7.1.3缩略语

                            7.1.4标志符内的成分位置

                            7.1.5要避免的名称

              7.2指令、伪指令和伪操作码

                            7.2.1选择最好的指令序列

                            7.2.2控制结构

                            7.2.3同意义的指令



8.0数据类型     

              8.1用TYPEDEF定义新的数据类型

              8.2创建数组类型

              8.3在汇编语言里声明结构体

              8.4数据类型的UCR标准库




因该网站使用了防止盗链技术，请下载文件的朋友使用下载工具进行下载，切勿使用右键另存为！

 
高清晰PDF文件下载