CSDN博客

img jiangtao
博客专家

组 合 语 言 之 艺 术(二)

发表于2000/8/12 1:09:00  2564人阅读

究其因,在学习、思考时,当是原则重於细节,然而在执行的过程中,却是细节重於原则。此外,事物变化的组合无穷无尽,主事者必须能针对目标,随时根据实际状况,逐步处理。
        在各种状况中,如若程式师不能掌握当前的重点,则凡事皆如有千头万绪,难以下手。事实上,从成事败事的观点来看,人只有两种,有能力者,是把复杂的事简化;无能力者,经常把简单的事变得复杂无比。而这种能力的差异,就在於能否掌握当前的重点。
        观念清楚了,就看当事人是否能认真负责,坚持贯彻到底。人间世事成败,完全基於这种态度。不认真,工作时草草了事,不可能有好的成绩;不负责更糟,没有问题也会产生问题,发生问题後,更是无人解决;若叁与工作的人多,彼此推卸责任,这样做人处世必将失败,程式制作亦然。
        所谓认真负责,具体说来,即是在事先要彻底了解该做什麽?要做什麽?以及如何去做?工作时要考虑怎样做最有效率?每一步骤会产生什麽结果?而工作完成後要彻底检查,目标是否已达成?能否再加以改进?
        最後,是对程式的品质及技巧的完美性,应锲而不舍地追求。一般人常把完美当作不必要的奢侈,其实不然,完美是一种永远无法达到的理想。重要的观点是,人只有在追求完美的过程中,才能不断地进步、升华。一个人若没有理想,就与动物无异,一个程式师若没有理想,套句爱因斯坦的名言,不过是只「训练有素」的小狗罢了。
        态度来自习惯,习惯则来自於学习及锻炼,有志向上者,应该自我要求,努力学习。等到锻炼久了,习惯成自然,有了良好的态度,终有成为大师的一天。

  3,软件开发的原则:
    分工合作,量材施用,慎重计划,严格执行,市场导向

        此处所说的软件开发,是指具有相当规模的程式,需要多数人员共同工作者。人多固然力量大,但是人与人的相处和沟通,问题也特别多。若处理得好,力量是正值,反之,则为负值。不仅彼此的力量相互抵消,有时还有不良的後果。
        软件开发,应该有一个主事的重心人物,如果要谈民主,不妨去搞政治。负责人首先要对工作内容详加分判,然後根据性质分配工作。分配时应注意工作量、时间要求、个人特性及相互的配合等因素,责任要划清,交待要明确,俾能集中众人力量,分工合作。
        成事在人,如果用对了人,则成功在望。每个人都有其独特的个性、能力及态度,适合於不同性质的工作和方法。所以应事先了解每个程式师的个性、能力及缺点,再行分配适合的工作。
        不仅分配工作时要度量才干,管理时亦然,人不是机器,不可能绝对适应同一种工作方式。但是,若每个人以他自己适应的方式工作,对整体而言,又有步骤不一、难以相互配合的弊病。
        比较理想的解决方式,是对叁与工作的人员,施以再教育,使之习惯於一种统一的方式,藉着训练的过程,也可增进对每个工作人员的认识了解。
        再就是工作计划,将工作分成几个阶段,并配合人员的分工及设备器材的条件,逐步实施之。
        工作计划相当於建筑蓝图,一旦确定了就难以修改。一个完整周详的计划,应包括了工作目标,人员分配,时间进度,执行细则,沟通方式,解决问题的程序等。
        有了计划,还要有监督执行的专责人员。这种人才必须有足够的经验,对全部计划能了解透彻,有敏锐的判断力,并敢於担当。工作时执行要严格,待人要宽厚,处理事务要果断。
        最後一项原则,才是真正的成败关键,那就是,产品要以市场需求为导向。不能符合使用者需求的产品,一定「没有用」,没有用的产品,则不具备任何价值。
        要测试产品是否「有用」,其实很简单,以程式师为例,如果自己都不愿采用,显然是用处不大。有人会说,程式师又不是使用者,在没有必要时,再好的产品都不肯用。这话并不尽然,人喜爱美好的、尤其是与自我有关的事物。如果程式真有用,制作的程式师一定会想尽方法去    玩赏、测试,而且乐此不疲。
        同理,程式师只有当自己不断的试用後,才会发现实际应用上,所可能面临的问题。而当问题解决以後,用得方便,有了实际效益,市场才有可能接受。

  4,工作环境的建立:

    环境安静,资料齐全,消息流通,压力合宜

        从事软件工作的人,可以说就是一个艺术家,艺术需要注入心智,需要个人无保留地投入。在这种情形下,环境相当重要,必须事先安排妥当。
        环境的物质条件并不重要,但是安静、卫生,却关系着艺术家心理及生理上的平衡。喧哔、吵闹会令人心烦意乱,难以专心。对艺术家而言,不能专心,就毫无创造佳作的可能性。当然,若只把软体发展视作生产线上的生产工作,那就不在话下了。
        程式是运用资料、处理资料的工具,写程式最怕的是资料不全,因为缺乏一点必须具备的资料,而使得整个计划受阻,是最可惜的事。同时,程式本身也是一种广义的资料,尤其是一些软件开发所必须的工具,都应事先准备齐全。
        由於电脑发展日新月异,新观念、技术层出不穷,资料永远难以收集完整。所以消息的流通性非常重要,在一个闭塞的环境  ,埋头苦干的结果往往会落在别人的後面而尚不自觉。更何况世界各国从事电脑工作者多不胜数,他山之石可以攻错,消息的流通常可使软件工作者节省大量的心力。
        最後是工作的压力,为了效率,压力要大;但站在人的立场,不论身、心,实在是经不住长期或太大的压力。所以,如何求取一个合宜的折衷点,是不容忽视的。
        以我的经验,一般人受年龄、经验、动机及意志力等的影响,承受压力的能力,不一而同。大概说来,年轻、初学者,在适当的动机下,能够承担长达三至五年、持续性的重大压力;有经验、年龄稍长,除非有极强的动机,再加上坚定的意志,才能维持下去。
        软件开发需要劳心劳力,艺术创作则更需要坚持执着的毅力,技术有方法、有步骤,一定可以实现。艺术则要有观念、有创意,加上心智的投注。两者融合,观念由大处着眼,技术由细部着手,是则,理想终将成为事实。

    第二章    准备工作

    第一节  系统

一、系统之选择

    只因真正了解电脑的人太少,迷信名气的结果,使得 IBM PC/AT占有了市场。为求电脑普及应用,我们唯有因陋就简,针对 IBM PC/AT及其兼容系统,作进一步的分析和说明。
    尽管使用 80486 CPU的微电脑已问世,我个人认为以其造价及功能而言,并不符合效率法则。在从事艺术工作的立场,价值的高低,与所采用的材料没有绝对的关系。更何况我们正要证明,利用组合语言的制作技巧,能够使功能不高的微电脑发挥最大的边际效益。故本书仅以8088 CPU指令为研讨对象,至於程式应用在什麽机型,就不在本书的考虑范围内了。

二、目录及磁碟

    假定读者为有经验的程式师,且电脑为 IBM PC/XT/AT。 则在着手制作程式之初,应该先将系统准备妥当。即所谓「工欲善其事,必先利其器」,如果未能注意到下面所提的细节,仅仅制作一、两个程式尚可应付。待工作量一大,程式渐渐增多,不是某些程式找不到,就是找到了也不能一目了然。结果是心烦意躁,马马虎虎,另外再写一个,勉强应付了事。
    硬碟空间较大,应行注意的事相对的也较多。首先应妥善规划好目录及子目录的分类及应用方式,否则每当要找一个档案时,往往有大海捞针之叹。再不然,在修改程式时,如果将不同的版本放在一起,一定会张冠李戴,错误百出。
    每位程式师都应该有自己的目录,而且每个不同的整套档案都应有不同的子目录,这样方能明确的分辨以及应用。而最有效率的方法是,在每一子目录中,档案数不宜太多,且仅存放在同一工作项目下所需要的程式。
    一旦硬碟坏了,所有贮存资料均将付诸流水。为了安全,一定要用软碟备份。最好每天复制一次,虽然每次复制,相当麻烦,但是万一程式被毁坏,那种损失是无从估计的。
    最好的方法,是制作一个专门复制的工具,一般用 .BAT 应用程式,每天工作完毕,只要执行一次即可。

三、应用工具

    程式写作是为了控制电脑运作,应用工具则是将程式师的观念和理解转化为能够连续执行的指令。因此,市面上的应用工具虽多,却不见得对程式的写作有所助益。下面列了几种,只要运用纯熟,绝对够用了。

    程式写作:EDLIN ,PE II,WS等。

    程式编译:MASM.EXE
              早期 (1.25) 版本容许较多的「外界标题」,即External Label,但该版本仅限用於8088指令,较宜大型程式处理。
              4.0 以前的版本,於档案开始时,可用.XCREF以产生标题及缓冲器的位址对照表。但後期的版本会发生错误,不能再用。

    程式联接:LINK.EXE
              早期的版本对 SEGMENT    PUBLIC 'xxxx' 有些规定,但 3.0以後,除了对CODE及 DATA 有效外,其他如 BYTE 及 WORD 等皆无作用。

    程式侦错:DEBUG.EXE 或 SYMDEB.EXE 及 MAPSYM.EXE
              後两者为套件,必须另购。其优点为在侦错过程中,可以使用原程式中的标题名称,且可设「断点」等,侦错方便,功能较强。

    系统处理:PCTOOLS.EXE 是 DOS下很有用的工具,可以作档案管理,也可用来直接修改程式机器码。此外,连机时可以用LL.EXE 或XTALK.EXE等。尤其是系统程式的侦错,经常需要用联机的方式,以另一台微电脑作为监视器。

    这些工具应统一放在 /DOS 子目录中,且须在系统之自动执行程式(AUTOEXEC.BAT)  ,先设妥优先通道(PATH)如:

    1:PATH=/DOS;
    是则,不论在哪一个子目录中,前述之工具皆可使用。

四、简化名称

    前述各种工具,在程式侦错过程中使用频繁,为了应用上的方便,如果能少输入一些字符,不仅节省时间,且可避免错误。令用者在惯性反应下,得以集中精神,思考其他细节。
    简化名称是最简单的方法,最好只用一个字母,由於长度相等,其後面的档案名称,就可以利用系统所提供的“F3”「复制上行」功能,不必再行输入。

    是以:EDLIN.COM 改为 E.COM
          MASM.EXE  改为 M.EXE
          LINK.EXE  改为 L.EXE
          DEBUG.EXE 改为 D.EXE
          SYMDEB.EXE 改为 S.EXE
    例如:在完成一个程式後,若要汇编,只要改第一个字母即可。
          C:/>E MYFILE.ASM ( 原来在系统中输入的字符 )
    此时仅输入“M”,再按“F3”键,立即变为:
          C:/>M MYFILE.ASM
    此外,如不需 .LST 等档案,则再加一“;”即可。
          C:/>M MYFILE.ASM;
    “L”及“D”等同样都可依循上面的方法,看来是雕虫小技,但实际上所节省的时间及精力却不同凡响。

五、叁考资料

    除专门性的资料外,程式师应该备妥各种有关输出、入,各种周边设备的叁考资料或手册等,以便随手查阅。
    最重要的是软件叁考手册 MS-DOS Software Reference,其中有各种中断命令的使用规格。唯应注意的,是有一些中断功能与IBM BIOS相同,我建议读者不要使用这些中断,因其调用过程中,要借道BIOS,会使速度减慢。
    其次为 IBM Programmer's Manual 的BIOS中断规格, 是处理所有周边设备必需的工具。
    正因为它涉及周边设备,在设计中文系统时,输出入、显示及列印等功能都有待修改,这本手册更须彻底了解。
    此外还有键盘的输入码表,也是编程必备的资料,本书附录三即为简要的码表介绍。
    如果是编写应用程式,上述的资料已足够应付,但若涉及系统,则尚需了解系统的记忆空间安排,下表为 IBM微电脑的记忆区结构。各种厂牌设计理念虽有差别,但大同小异。
    系统段  位  址              机  能  用  途
                    ┏                            ┓
    0000  0000H        中断调用表                   
                    ┣                            ┫
    0000  0500H        DOS 及系统操作区             
                    ┣                            ┫
    0000  4C00H        周边控制程式                 
                    ┣                            ┫
    0000  5400H        COMMAND 运用                 
                    ┣                            ┫
    0000 0E0A0H        使用者操作空间               
                    ┣                            ┫
    000A  0000H        萤幕缓冲区(VGA)             
                    ┣                            ┫
    000B  0000H        萤幕缓冲区(CGA,EGA)         
                    ┣                            ┫
    000C  0000H        EMS 记忆体扩充区             
                    ┣                            ┫
    000F  0000H        ROM BIOS  程式区             
                    ┗                            ┛
    上述之系统段,调入段暂存器中时,原来的 000AH应该是0A00H,馀同。
    又使用者操作空间的起始点,因各家设计而异。
    第二节  应用工具的制作

一、联接目标档(OBJ Files)

    程式完成以後,相互间的联结,越大越难,有时是结构的改变,有时是档名的变动。不论什麽因素,在在都需要加以维护,而且对工作效率关系重大。

    因此,需先建立一个 DO.BAT 的执行档,其内容为:
    1:LINK/M @XXXX
    此 XXXX 为一记录档,其中记载所有需联结的目标档名,如果有任何异动,直接更改此档即可。
    在联结时,执行 DO 即可。

    例如:要制作 DRAW.EXE 档,已有 DR1.OBJ .. DRn.OBJ 以及DR-SEG.OBJ 等档,则此 XXXX 档内容应为:
    1: DR-SEG+
    2: DR1+DR2+.. DRn
    3: DRAW,DRAW,,
    在执行 DO 後,如果没有错误,所产生的 DRAW.EXE 以及DRAW.SYM 即可供测试。

    也可在第三条後加入:
    4: SYMDEB (或仅用 S)DRAW.EXE DRAW.SYM
    似此,在发展初期,立即可以测试。如果不需再次联结,将第四条另外作一 .BAT 档,随时执行亦可。

    另外有一点需要注意的是,为了要让可执行的程式由指定的起点开始,应在原始档 .ASM 的结束格式标记‘END '後,加一起点的标题名称。
    此标记不论有多少,联接目标档时,会以第一个找到的标题为唯一的入口。如果程式很多,叁与工作的程式师也多,在分开测试时,经常使用自己的入口,一旦联接在一起,就可能发生错误。
    解决的方法是由负责联接的程式师,事先准备好前述XXXX记录档,将带有入口标记的程式放在最前面即可。当然,将其他程式标记後的标题删除亦可,但不如前法效率高。

二、目标档侦错及工具

    在使用 DEBUG时,因为名称简短,用法也简单。若使用「标题侦错」SYMDEB.EXE则不然,因为首先要生成.MAP档,测试时,输入文字也较多。对不断使用的人来说,难免嫌烦。简化的方法,是先制作执行档:S.BAT 及 SM.BAT

    S.BAT 是专供指定程式侦错用,内容为:
    1:SYMDEB %1.SYM %1.EXE
    这是指已经有了原档的 .MAP 时,如果程式刚联接完毕,且在联接档中,没有生成 .MAP 的语句,则应制作 SM.BAT 如下:
    1:MAPSYM %1.MAP
    使用「标题侦错」工具有很多优点,其功能较 DEBUG强得多。但是使用者必须注意,需要测试的标题,应该在程式中宣告PUBLIC,否则无法直接跳到该处。
    尚有些特殊效果的程式,也应备妥测试的工具,甚至以利用「监视器」的方式,用另外一台电脑来控制。有一些通讯软件,如 XTALK加上SYMDEB.EXE,通过串行埠(Serial Port )可以联机调试,其手续如次:

  1,先在待调程式的主机上输入通讯指令:
    C:/>MODE COM1:9600,N,8,1
    C:/>SYMDEB MYFILE.EXE

  2,再於已与主机经串行埠联接的副机上输入:
    C:/>XTALK
    进入指令输入状态,再输入:
    C:/>SP
    表示设定传输速度,一般多采用9600,但视主机而定。
    C:/>9600
    最後,输入操作指令:
    C:/>GO LO
    表示用区域网络,即串行埠口。
    这时等待联机成功的讯号,见到萤幕上出现“  ”,即可    开始侦错。

  3,在主机方面,尚要输入:
    C:/>=COM1 ( 或COM2,端视双方的通讯口而定 )

  4,至於侦错方式,与利用一台电脑时相同,只是此时在主机上出现的是执行後的结果,而由副机控制侦错步骤。
    第三节  分类定义

一、段名(Segment Name)定义

    对段名多於一个的程式,最好先有一个定义段的程式,以DRAW为例,假定程式为两段,一为控制程式段,一为绘图程式段。资料分为三段,一为应用资料,一为叁考资料,以及制作资料。此外还有一资料索引段,合计有六个段。
    兹建议,在通用的基础上,简化段名,将段分类如下:
    程式段 (CODE SEGMENT) 定名为 CG
    资料段 (DATA SEGMENT) 定名为 DG
    索引段 (INDEX SEGMENT)定名为 IG
    记忆段 (MEMORY SEGMENT) 名为 MG
    特设段 (EXTRA SEGMENT)定名为 EG
    堆栈段 (STACK SEGMENT)定名为 SG

    当各段超过一组时,则再加数字以区分之。
    如在 DR-SEG.ASM 中,可设为:
    1: TITLE  SEGMENT DEFINITION OF PROGRAM ‘DRAW'
    2: CG1    SEGMENT PUBLIC
    3: CG1    ENDS
    4: CG2    SEGMENT PUBLIC
    5: CG2    ENDS
    6: DG1    SEGMENT PUBLIC
    7: DG1    ENDS
    8: DG2    SEGMENT PUBLIC
    9: DG2    ENDS
  10: DG3    SEGMENT PUBLIC
  11: DG3    ENDS
  12: IG      SEGMENT PUBLIC
  13: IG      ENDS
  14:        END
    在 SEGMENT PUBLIC 之後,有多种表示方式:
    SEGMENT PUBLIC XXXX
        XXXX=CODE 表示为程式段,在联接时,属程式的段与段前後衔接。两段程式之间,以 000H 填充至「节」( 每十六个字元为一「节」 )之首位。
        XXXX=DATA 表示资料段,在联接时同上。
        如果程式师为了某种原因,必须严格控制程式之位置及长度时,不宜使用上述两种方式。
        最简单之陈述方式,即在 SEGMENT PUBLIC之後,保持空白。
        XXXX=BYTE 表示程式联接後,各程式之间紧密接合,不留空位。这种方法,有利於程式精简。
        XXXX=WORD 表示程式联接後,各程式之间紧密接合,但在後面的程式必然由双数位起。

    又如在 XXXX 前後加以引号如:
    SEGMENT PUBLIC 'XXXX'
    此一宣告,用以通知汇编程式各段的顺序及定义。因此在编写程式时,只要使用的段名及定义与本档相符,不管将各段安排在程式任一位置,都不致发生错误。
    ‘XXXX'与本段程式的排列顺序有关,在联接时,先将引号中的字串排序妥当,各程式即依此顺序排列之。
    也就是说,凡是使用了引号,则程式联接的顺序,即以在引号中字串,於联接时出现先後为顺序。
    单一程式档的错误不难测知,但若各段之间发生错误,对经验不足的程式师,将有无从下手之虞,不得不慎!
    一般说来,在联接时,最令人头痛的错误讯息为:
    'Fixup overflow at nnnn..'
    不论其错误提示内容如何,此种错误的发生,多半是因为段与段之间的标题、缓冲器或是暂存器的使用发生了混淆,联接程式得不到正确的信息所致。
    解决方法是在第一个错误讯息出现时,立刻以‘Ctrl_C'停止汇编,记下第一个讯息,再在原程式中,找到该位置,(多半为一标题位置)在此标题之前,一定会发现与「段」有关的错误。

二、原始档(Source File)档名定义

    在共同设计大型模组时,程式师间的默契,全赖事先相互约定。否则程式越大,所面临的困难将越多,经常耗时费事,甚至最後功败垂成。
    因此,在设计之初,必须妥善规划,将一应有关的档案、名称、功能等,皆明确地加以定义。叁与设计的程式师,更必须严格遵守,方能得心应手。
    原始档名的定义,其目的有三:
  1,代表程式设计者:当制作的程式甚多时,一见档名,就应能分辨出各个程式的设计人。再如某程式师所编程式在一    个以上,则应在其本人代码之後,加一数字编号。这样,遇有任何问题,立即可以找到来处,进行追踪。

  2,代表程式功能:每当联结後发生问题时,应能由档名查知问题所在,故每种功能宜给予适当的名称。

  3,代表联结的关系:除了功能外,有时尚须表示各程式之间的联结关系。如某一程式必须安排在另一程式之前或後,亦应在档名最後,以数字表示顺序。
    若叁与的程式师不超过廿人,则以一字元为限,各人事先选定一个字母,作为档案名称的第一字元。第二字元则视该程式师是否编写一个以上的程式而定,是则取一数字代表之,若无则免。
    功能以三到六字元为宜,能统一长度将更为方便,馀下一字元留供数序用。
    例:程式师代号为‘C',本程式之编号为3,功能为‘DRAWS',此外并无联结关系,则其名应为:
        CDRAWS3.ASM

三、标题定义

    程式在整理或测试时,最大的困扰,是寻找某一个标题的出处或功能。如果在同一档中,尚可利用CREF.EXE,列印出一份对照表来;如果不知道出自哪一个档案,在众多的程式中,就只有望洋兴叹了。
    至於功能,如名称定得太长,不仅输入、修改不便,而且会使得程式看来杂乱无章,令人眼花撩乱。如果定得太简单,或各人任意定名,则难以理解。
    所以,标题定名之重要性,不下於程式之写作。尤其是在叁与人数众多时,标题不仅要统一,而且要能代表所有必备的讯息。
    标题所代表的讯息有:
          A x x x x x x x x
            ┗┳┛┗┳┛┗    分支代号
                    ┗        延伸定义
              ┗              功能名称
          ┗                  程式出处

  1,程式出处:如果很多人同时叁加一个计划,而某程式师仅写了一个程式,此定义即为该程式师之代码。否则尚要附    加编号,以便随时可查到。即使只有一个人写作程式,程式可能不断扩大,为了制作的方便,或为了模组的分割,常有必要将程式分到其他档中。因此,一段程式究竟出自於哪一个档案,全赖标题表明,以便能迅速地找到。
        程式出处一般用一个字母即可,如前述第一个字母A代表此段程式来自编号为A的原始档;或属於以A为代号程式师的程式。

  2,功能名称:除若干已知会用到的功能可以事先定义外,其馀的多半是在发展过程中,针对需要而产生。对功能定义千万不要掉以轻心,一个程式的再利用价值,常与其功能定义息息相关,明确的定义,可以令人对其功能及应用方式一目了然。
        功能名称长度以三个字母为宜,太长则输入费时,尤其是国人不见得个个英文了得,与其写错,不如藏拙。
        如:DSP 表示萤幕显示功能
            PRN 表示列印功能
            KIN 表示键盘输入功能

  3,延伸定义:若功能相同的程式过多,2,中的定义方式难以分辨,则可再加一延伸定义。
        如:DSPDOT表示显示点阵
            PRNCHI表示列印中文
            KINASC表示输入 ASCII 字符

  4,分支代号:在程式中常有分支,分支代号最理想是由小而大,依序安排。但由於写作时常难以预知後情,故宜先留空号,以便扩充。
        如:DSPDOT10
            PRNCHI06
            KINASC24

四、缓冲器定义

          B x x x x x x x
              ┗┳┛┗┳┛
                      ┗      延伸定义
                ┗            功能名称
            ┗                类型
          ┗                  缓冲器保留字

        第一个字母规定用‘B',为缓冲器保留字。
        第二个字母定义其类型:
        Q=QWORD    如:BQxxxx 缓冲器长度为8字元。
        D=DWORD    如:BDxxxx 长度为4字元。
        W=WORD      如:BWxxxx 长度为2字元。
        B=BYTE      如:BBxxxx 长度为1字元。
        S=STRING    如:BSxxxx 不限长度,但限BYTE型。
        O=ORIGINAL  如:BOxxxx 表不可破坏的原始资料。
        F=FLAG      如:BFxxxx 用作旗号。
        第二字母以後所采用功能或延伸定义,与三、2,3相同。此外,所有缓冲器皆应统一设在缓冲器专用程式中,若系临时使用,或尚未正式联接,亦应设在各程式之首,以便於查阅、修改。

    第四节  统一格式

一、格式统一之优点

    不论采用何种程式语言,凡是共同工作、须相互研讨,或者在同一部门中,分担成败责任者,应该有统一的程式写作方式。这样不仅便於沟通,提高程式的品质,且可避免因某一程式师之离职或出缺所造成的後遗症。
    良好的程式,应如一篇美妙的文学作品,其中有技巧,有意境。其功能不仅表现在执行的效率上,也可以作为同行间学习、欣赏的媒介,这些都必须透过统一的格式达成。
    尤其是把组合程式写作当作一种艺术创作,就必须经常相互观摩,如果没有共通的格式规定,则这样的程式和「天书」可以说没有多大的分别。不论注释写得再好,一般程式师自己都怕看自己的程式,更何况叁阅他人的? 但若有统一的格式,养成习惯後,不仅易看易懂,而且寻找、修改方便,写作也轻松省事。

二、规格

  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
    【备注】:以本功能取中文内码,须连取4次,依序得
              到一中文4字元内码。
    当然,如果时间充足,最好能有程式的全部说明,以及制作、修改的细部记录。
    问题在於任何程式发展之初,一定乏善可陈。再加上不断的修改、增补,其间变化复杂无比。程式师又要全神贯注,解决问题,又要考虑如何注记,一心两用,必然谈不到效率。
    那麽怎样做才对呢?我建议先让程式师自由发挥,在初期有无注记无关紧要。待程式完成了,大致上没有错误,这时,就应该停下来,从头到尾,将程式彻底整理一番。
    这样不仅加注记容易,而且程式师有机会重新「欣赏」自己的心血结晶,该改的改,该合并的合并,该删的删。最後,程式师经过反思,研究,技术将会大幅度进步,程式更精简,注记也正确无误,工作也达到最高效率。

0 0

我的热门文章

相关博文

img
取 消
img即使是一小步
也想与你分享
打开
img