006-代码标准文档.pdfVIP

下载 第6章 代码标准文档 本章内容： • 一般的源代码格式规则 • Object Pascal • 文件 • 窗体与数据模块 • 包 • 组件 • 代码标准文档升级 本章描述书中使用的 D e l p h i编码标准。一般来说，本章主要是为开发组提供一个方法，使他们在 编程时有一致格式可遵循。这样，开发组中每个编程人员编写的代码能够被其他人理解。这要求大家 使用一致的代码样式。 本章不可能包括代码标准的每个细节。但是，足以让您能够开始工作。你可以自由地使用和修改 这些标准，以满足不同的需要。不过，我们并不建议你在这些标准上花太多的时间。我们之所以介绍 这些标准，是因为当新的开发人员加入开发组时，他们可能已经对 B o r l a n d 的标准很熟悉。与大多数代 码标准文档一样，你可以在下面网址找到最新版本的帮助： w w w. x a p w a r e . c o m / d d g 本章不包含用户界面标准。用户界面标准是独立于其他标准的，并且同样是重要的。大量的书籍 和M i c r o s o f t文档包含有关这个标准的说明，因此这里不再赘述。建议你到Microsoft Developers Network 和其他可能的地方去查看一下这些信息。 6.1 一般的源代码格式规则 6.1.1 缩进 缩进就是每级间有两个空格。不要在源代码中放置制表符。这是因为，制表符的宽度随着不同的 设置和代码管理实用程序(打印、文档及版本控制等)而不同。 通过使用 Tools | Emvironment菜单，在Environment Options对话框的G e n e r a l页上，不要选中U s e Tab Character和Optimal Fill复选框，这样，制表符就不会被保存。 6.1.2 边距 边距设置为8 0个字符。源代码一般不会因写一个单词而超过边距，但本规则比较灵活。只要可能， 长度超过一行的语句应当用逗号或运算符换行。换行后，应缩进两个字符。 6.1.3 begin...end b e g i n语句必须单独占一行。例如，下面第一行是错误的，而第二行正确： 第6章 代码标准文档 1 3 1 下载 for i:=0 to 10 do begin // 错, begin 与f o r在同一行 for i:=0 to 10 do // 对, begin在另外一行中 b e g i n 本规则的一个特殊情况是，当b e g i n为e l s e语句的一部分时，例如： if some statement=then b e g i n . . . e n d else begin S o m e O t h e r S t a t e m e n t ; e n d ; e n d语句总单独一行。 当b e g i n不为e l s e语句的一部分时，相应的e n d语句与b e g i n语句的缩进量相同。 6.2 Object Pascal 6.2.1 括号 在左括号与下一字符之间没有空格。同样，右括号与前一字符也没有空格。下面的例子演示了正 确与不正确的空格。 CallProc( Aparameter ); // 错! CallProc(Aparameter); // 正确! 不要在语句中包含多余的括号。在源代码中，括号只有在确实需要时才使用。下面的例子演示了 正确与不正确用法： if (I=42) then // 错，括号是多余的 if (I=42) or (J=42) then // 正确，必须使用括号 6.2.2 保留字和关键字 Object Pascal语言的保留字和关键字总是完全的小写。 6.2.3 过程和函数 1. 命名与格式 例程名应当以大写字母开始，且大小写交错以增加可读性。下面是一个不正确的写法： procedure thisisapoorlyformattedroutinen