第四节  统一格式

一、格式统一之优点

不论采用何种程式语言，凡是共同工作、须相互研讨，或者在同一部门中，分担成败责任者，应该有统一的程式写作方式。这样不仅便于沟通，提高程式的品质，且可避免因某一程式师之离职或出缺所造成的后遗症。

良好的程式，应如一篇美妙的文学作品，其中有技巧，有意境。其功能不仅表现在执行的效率上，也可以作为同行间学习、欣赏的媒介，这些都必须透过统一的格式达成。

尤其是把组合程式写作当作一种艺术创作，就必须经常相互观摩，如果没有共通的格式规定，则这样的程式和「天书」可以说没有多大的分别。不论注释写得再好，一般程式师自己都怕看自己的程式，更何况参阅他人的? 但若有统一的格式，养成习惯后，不仅易看易懂，而且寻找、修改方便，写作也轻松省事。

二、规格

1,统一用大写字母，以利于阅读。
  2,空格处应采用 TAB，齐头等距，一目瞭然。
  3,标题之后立即改行输入，以便阅读。
  4,每行不得超过70个字母，以免长度不等，画面紊乱。
  5,注记位于指令后，在第五个 TAB的起点，空间不足时，可换行，但位置齐一。
  6,所有缓冲器统一定义在程式之前，不可夹杂在程式中间。
  7,除了需要作超过程式段的FAR CALL使用‘PROC FAR’外，切勿使用‘PROC NEAR ’形式，因这种写法毫无意义。 
  8,程式开始时，应有注记说明使用要点。

以下举例说明统一格式：
　　1: PAGE  60,132
　　2: TITLE [程式名],[程式师代号],[编号],[功能说明]
　　3: 
　　4: DG   　　SEGMENT PUBLIC 
　　5:      　　extrn   bwsca1:word,..
　　6: DG   　　ENDS
　　7:
　　8: ..
　　9: ..
   10: ..
   11:
   12: CG   　　SEGMENT PUBLIC 
   13:      　　extrn   mmmm:near,..
   14:      　　..
   15:      　　public  xxxx,yyyy,..
   16:      　　ASSUME  CS:CG,DS:DG,ES:DG
   17: ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
   18: ;   REM …………                   　　;
   19: ;   　　………………….         　　;
   20: ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
   21: START:
   22:      　　CLD
   23:      　　MOV 　　AX,DG
   24:      　　MOV 　　DS,AX
   25:      　　..
   26:      　　..
   27:      　　..
   28:
   29:CG    　　ENDS
   30:        　　END 　　START

第一条的 PAGE 是供列印用的「保留指令」，表示每页所印的行数及列数。其后之 60,132 即为60行， 132个字符。

第二条的 TITLE  为供查阅之「保留指令」。

前述REM 注记栏中，应说明该段程式的功能、应用条件，以便其他程式师共同使用。

三、注记

注记的目的在于日后自己或他人能很容易地做程式修改、维护。因此所做描述当力求详尽。不幸的是，不论多么精彩的文句，总有不足之处。因此，注记时需把握重点，大体说来，程式需加以说明的，不外：

1,功能：做什么工作，需要何种先决条件。
  2,参数：设些什么数据，以供本段程式处理。
  3,缓冲器：用什么缓冲器，其工作特性如何。
  4,结果：执行后所产生的结果。
  5,子程式调用：在本段程式中，所需调用的子程式名。
  6,重要声明：如暂存器是否被破坏，或其他注意的事项。
　　如：
　　【功能】：读键盘缓冲区输入码，依性质返回ASCII＋扫
          　　瞄码或中文内码
　　【参数】: AH = 00H
　　【返回】: 11AL< 80H，AH = 扫瞄码，AL = ASCII
          　　12AL≧80H，AL = 四字元中文内码之一
　　【破坏暂存器】：AX
　　【备注】：以本功能取中文内码，须连取４次，依序得
          　　到一中文４字元内码。

当然，如果时间充足，最好能有程式的全部说明，以及制作、修改的细部记录。

问题在于任何程式发展之初，一定乏善可陈。再加上不断的修改、增补，其间变化复杂无比。程式师又要全神贯注，解决问题，又要考虑如何注记，一心两用，必然谈不到效率。

那么怎样做才对呢？我建议先让程式师自由发挥，在初期有无注记无关紧要。待程式完成了，大致上没有错误，这时，就应该停下来，从头到尾，将程式彻底整理一番。

这样不仅加注记容易，而且程式师有机会重新「欣赏」自己的心血结晶，该改的改，该合并的合并，该删的删。最后，程式师经过反思，研究，技术将会大幅度进步，程式更精简，注记也正确无误，工作也达到最高效率。