软件编码规范.doc

软件编码规范.doc软件编码规范 文件状态:[√]草稿[]正式发布[]正在修改文件编号:RDC-DED-SCS-SPC-00当前版本:作者:审核人:完成日期:中国人民银行清算总中心支付系统开发中心文档修订记录版本编号变化状态简要说明日期变更人批准日期批准人注:变化状态:A—增加,M—修改,D—删除目录第一篇 C/C++编码规范 6第一章 代码组织 6第二章 命名 文件命名 变量命名 常量与宏命名 类命名 函数命名 参数命名 11第三章 注释 文档化注释 语句块注释 代码维护注释 20第四章 编码风格 排版风格 头文件 宏定义 变量与常量 条件判断 空间申请与释放 函数编写 类的编写 异常处理 特殊限制 40第五章 编译 41第六章 ESQL/C编码 46第二篇 JAVA编码规范 47第一章 代码组织 48第二章 命名 包命名 类命名 接口命名 方法命名 变量命名 类变量命名 常量命名 参数命名 52第三章 注释 文档化注释 语句块注释 代码维护注释 59第四章 编码风格 排版风格 包与类引用 变量与常量 类编写 方法编写 异常处理 特殊限制 71第五章 编译 73第六章 JSP编码 文件命名及存放位置 内容组织 编码风格 注释 缩进与对齐 表达式 JavaScript 79第三篇 POWERBUILDER编码规范 80第一章 代码组织 81第二章 命名 文件命名 对象命名 变量命名 常量命名 函数与事件命名 参数命名 85第三章 注释 文档化注释 语句块注释 代码维护注释 88第四章 编码风格 界面风格 排版风格 变量与常量 条件判断 空间申请与释放 函数编写 特殊限制 97第五章 SQL编码 98前言程序编码是一种艺术,既灵活又严谨,充满了创造性与奇思妙想。然而应用软件设计是一项团结协作工程,而非程序员展示个人艺术的舞台,大型应用软件项目更是由很多程序员组成的大型开发团队协同完成的。每个程序员都有自己的编码经验与风格,如果缺乏统一的编程规范,则可能导致软件产品最终程序代码风格迥异,可读性与可维护性均较差,不仅给程序代码的理解带来障碍,也增加维护阶段的工作量。此外,经验证明不规范的编码行为往往还会导致程序出现更多的隐含错误。为规范编码行为,增强程序代码的可读性、可维护性,提高编码质量与效率,保障应用软件产品整体品质与可持续开发性,特制定本规范。本规范分C/C++编码规范、Java编码规范、PB编码规范三篇,分别从代码组织、命名、注释、编码风格、编译等方面加以阐述。规范文本分为规则与建议两种,其中规则是强制执行的条款,建议则由程序员根据实际情况灵活掌握。C/C++编码规范代码组织使用不同的文件分别放置模块的约束与实现。C++,;,。一个模块可以包含一个类或功能上紧密联系的多个类。禁止将功能关联松散的多个类,放置到一个模块中。模块约束应仅包含模块对外提供的功能,禁止将模块内部使用的功能声明在模块约束中。下例中IsChineseChar()是内部使用的函数,不提供给外部应用使用,。(constchar*sInStr);(constchar*s){……;}BOOLIsChineseString(constchar*sInStr){for(intii=0;ii<strlen(sInStr);ii++){if(!IsChineseChar(sInStr+ii)){returnFALSE;}}returnTRUE;}简单应用应创建下列目录结构,模块程序代码应分别放置到src/include目录与src/source目录,编译文件放置到src/source目录,编译后的可执行文件放置到rel/bin目录,