软件工程第七章实现演示教学.ppt

第7章 实现;重点和难点;7.1 编码;;7.1.2 编码风格;1程序内部文档 序言性注释： 通常置于每个程序模块的开头部分，它应当给出程序的整体说明，对于理解程序本身具有引导作用。有关项目包括： 程序标题； 有关本模块功能和目的的说明； 主要算法； 接口说明：包括调用形式，参数描述； 有关数据描述：重要的变量及其用途，约束或限制条件，以及其它有关信息； 开发简历：模块设计者，复审者，复审日期，修改日期及有关说明等。;2数据说明 命名规范 标识符，包括模块名、变量名、常量名、标号名、子程序名、数据区名以及缓冲区名等。 一个系统的命名必须一致。比如采用匈牙利命名法。例：pstrName 选用具有实际含义的标示符，以利于对标识符的理解 为了便于程序的输入，标识符的名字不宜过长。 为了便于区分，不同的标识符不要取过于相似的名字。如student和students易在使用或阅读时才生混淆。;3 语句的构造 书写格式 最好在一行上只书写一条语句。 例如，有一段排序程序FOR I:=1 TO N－1 DO BEGIN T:=I；FOR J:=I＋1 TO N DO IF A[J]＜A[T] THEN T:=J；IF T≠I THEN BEGIN WORK:=A[T]；A[T]:=A[I]；A[I]:=WORK；END END； 由于一行中包括了多个语句，掩盖了程序的循环结构和条件结构