delphi编码规范

1、Delphi编程规范编写目的本规范定义为程序在编写过程中涉及到的程序文件和编码风格。本规范以 Delphi 语言为标准制定.项目文件的组织在Delphi中，按照项目为单位来组织程序文件。在一个典型的项目中包括：项目文件（.DRP文件）含有工程主程序的Pascal源代码；单元文件（.PAS文件）项目中每个窗体的Pascal源文件，包含该窗体的所有声明和过程（包括时间处理过程）；窗体文件（.DFM文件）含有一个窗体的设计属性的二进制文件，每个窗体的.DFM文件与.PAS文件相互对应；资源文件(.RES文件)编译的二进制资源文件，被链接到应用程序的可执行文件中；项目选项文件(.DOF文

2、件)存储了Project|Options菜单命令所设置的项目选项；桌面设置文件(.DSK文件)存储了Tools|Options菜单命令所设置的桌面选项；包文件(.DPK/.BPL文件)用于共享组件、类、数据和代码的文件。源文件为.DPK文件，编译后为.BPL文件；常量定义内容：逻辑值的定义；常数值的定义；错误码的定义；格式：一个定义占一行。如下：Const <常量> : 类型 = 值; /注释说明： 使用 Const 语句来声明用于代替文字值的常数。示例：Const C_SQL:string='select CH_USERER_ID from T_CD_USER'

3、/查询用户ID Const C_PI:real =3.1415926; /圆周率结构类型定义内容：结构类型定义格式：Type <类型名> /结构说明注释 <变量名1> : 变量类型; /变量说明注释 <变量名2> : 变量类型; /变量说明注释End ;说明：<类型名>是以大写字母开头的字符串。结构定义中定义变量类型的语句从第二行第五列开始。示例：type TableList=record /系统树单元类型定义 InID: Integer; /单元编号 Name: string; /单元名称 PID: string; /上一级单元名称 PT: P

4、TableList; /指向下一单元类型的指针 end;程序风格程序风格规定了每个语句的定位规则及程序中的注释。函数(function)/过程(procedure)风格<function/procedure> Name (变量: 变量类型,);/函数/过程说明var 变量1：变量类型；/变量说明 变量2：变量类型；/变量说明 begin 语句; 语句; end ;注： 变量声明、语句均从第三列写起，如有缩进，每次缩进两列，并与相对应语句对齐。语句风格说明：在程序体中通常最多每十行有一个段落功能说明；规范使用各种语句；语句中有缩进是以二列为单位。变量定义语句var var_name

5、： <数据类型>；赋值语句var_name: = <表达式>条件语句if 条件 then /注释begin 语句; end else if 条件 then /注释 begin 语句; . endelse /注释 语句;注：如果执行语句只有一句，可省略begin、end语句。循环语句/循环功能注释for counter := start to end dobegin 语句; end;/循环功能注释while condition dobegin 语句; end;/循环功能注释repeat 语句; until condition开关语句/开关功能说明case <表达示&

6、gt; of <值1>:语句1; <值2>:语句2; <值n>: 语句nend；注释行在程序代码单元文件顶端必须拥有本单元文件“模块说明”及“单元说明”注释。对于常量、结构类型、函数/过程、自定义变量、代码段功能块、关键语句等有含义的代码部分，必须有注释行进行详细说明。注释行可在需说明部分行后以“/XXXXXXXX”方式添加，也可在需说明部分行上以“XXXXXXXX”方式添加多行或以“/XXXXXXXX”方式添加一行。文件及窗体命名 含义 类名 命名格式工程文件 Program(.DPR) XXXXX 单元 Unit(PAS) uXXXXX 窗体 Form.Name(.DFM) XXXXXFrm数据模块 DataModule XXXXXDM单元头定义，添加到每个单元的前面。*单元名称：功能描述：作者：软件名称：版本：公司名称：刀剑如梦软件创作室* 软件版本号格式定义：软件中采用如下的版本号格式：X.X.X.X例如：可发布的程序完成后将版本号标为””第一位：版本号。注：软件又重大的改进后形成的版本。第二位：维护号