6软件工程【荐】.ppt

6.2 程序设计风格（Programming Style） 程序设计风格也称编程风格。一般是指人们编制 程序时所表现出来的特点、习惯、逻辑思路。培养良 好的程序设计风格可以使程序清晰易读，减少错，不 但能提高软件开发率，还为以后的软件维护奠定了良 好的基础。主要从以下方面注意编程风格： 1.源程序文档化 2.数据说明 3.语句结构 4.输入／输出方法 6.2.1 源程序文档化 源程序的文档化包括恰当的标识符、适当的注释 和标准的书写格式。 6.2.1.1 恰当的标识符 标识符即符号名(包括文件名、模块名、变量名、 常量名、标号名、子程序名、数据区名以及缓冲区名 等)。 符号名应有一定的实际意义, 名字的长度要适中。 例如： 表示次数的量用Times表示； 表示总量的用Total表示； 表示平均值的用Average表示； 表示和的量用Sum表示。 选择名字应有精炼明确的意义，不是越长越好。 必要时可使用缩写名字，但这时要注意缩写规则要一 致，并且要给每一个名字加注释。同时，还要求在一 个程序中，一个变量只应用于一种用途。 (1)NEW_BALANCE_ACCOUNTS_PAYABLE 意义明确; NBALAP 使用缩写，虽然代表了较多 的信息，但意义不够明确。 N 过于简单含义不清。 (2)TEMP 在一个程序中，若前半段TEMPERATURE—— 温度，后半段TEMPORARY ——临时。这样使用变 量名是不可取的，同一个变量名应代表相同的含义。 6.2.1.2 适当的注释 夹在程序中的注释是程序员与日后的程序读者 之间通信的重要手段。注释决不是可有可无的。 一些正规的程序文本中，注释行的数量占到整 个源程序的1／3到1／2，甚至更多。 注释分为序言性注释和功能性注释。 序言性注释 通常置于每个程序模块的开头部分，它应当对 程序的整体进行说明，对于理解程序本身具有引导 作用。有些软件开发部门对序言性注释做了明确而 严格的规定，要求程序编制者逐项列出。 序言性注释的有关项目包括： 1.程序标题； 2.有关模块的功能和目的； 3.主要算法说明； 4.接口说明：包括调用形式，参数描述，子程序 清单； 5.有关数据的描述：重要的变量及其用途，约束 或限制条件，以及其它有关信息； 6.模块的位置：在哪一个源文件中，或隶属于哪 一个软件包； 7.开发简历：模块设计者，复审者，复审日期， 修改日期及有关说明等。 功能性注释 功能性注释嵌在源程序体中，用以描 述其后的语句或程序段是在做什么工作， 或是执行了下面的语句会怎么样。而不要 解释下面怎么做。 例如: /* ADD AMOUNT TO TOTAL */ TOTAL = AMOUNT＋TOTAL 程序的本意是将月销售额累计加到入年 度总额，但对注释的直观理解是：把销售额 加到总和中，此注释不好，若改写 成如下注释，便使读者理解了语句的意图： /* ADD MONTHLY-SALES TO ANNUAL-TOTAL */TOTAL = AMOUNT＋TOTAL 使用功能性注释的要点: 1.格式安排合理，利用缩进或空行区分程序和注释； 2.为重要的程序段添加注释，而不是每一条语句； 3.注释的内容不仅仅是对语句的简单翻译，而且是 一些功能和技巧上的说明； 4. 注释的意思要正确，修改程序时，注释内容要 随之修改。 5.避免在注释中使用缩写。 6.2.1.3 标准的书写格式 用统一的、标准的格式书写源程序清单，有助 于改进可读性。 1. 书写表达式时，恰当使用空格或圆括号等作 隔离符。 这样可以突出运算的优先性，避免发生运算的 错误。 例如 ：应将表达式 (A＜－17)ANDNOT(B＜＝49)ORC 写成 (A＜－17) AND NOT (B＜＝49) OR C 2. 在注释段的周围加上边框。 注释段与程序段、以及不同的程序段之间应用 空行隔开。 3. 用分层缩进的写法书写选择结构和循环结构。 把该结构中程序段语句向右做阶梯式书写，使程 序的逻辑结构更加清晰。 例如，两重选择结构嵌套， 写成