软件开发命名规范.doc

《软件开发命名规范.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、软件开发规范（汪进2010-12-7）目录C++命名规范11文件结构21.1文件信息声明21.2头文件的结构31.3定义文件的结构41.4头文件的作用51.5目录结构52命名规则52.1共性原则62.2Windows变量命名规则63程序风格83.1空行83.2代码行93.3代码行内的空格93.4对齐103.5长行拆分113.6修饰符的位置123.7注释123.7.1文件头的注释133.7.2函数头的注释134函数设计134.1参数的规则144.2返回值的规则144.3函数内部实现的规则164.4其它建议174.5

2、使用断言184.6引用与指针的比较185附录：变量类型定义20C#命名规范201ADO.NET命名规范202WinFormControl命名规范213WebControl命名规范21C++命名规范在研究项目团队协作开发的情况下（这里的团队协作也适合于应用项目的开发），编程时应该强调的一个重要方面是程序的易读性，在保证软件速度等性能指标能满足用户需求的情况下，能让其他程序员容易读懂你所编写的程序。若研究项目小组的所有开发人员都遵循统一的、鲜明的一套编程风格，可以让协作者、后继者和自己一目了然，在很短的时间内看清楚程

3、序结构，理解设计的思路，大大提高代码的可读性、可重用性、程序健壮性、可移植性、可维护性。制定本编程规范的目的是为了提高软件开发效率及所开发软件的可维护性，提高软件的质量。本规范由程序风格、命名规范、注释规范、程序健壮性、可移植性、错误处理以及软件的模块化规范等部分组成。本软件开发规范适合讨论C/C++程序设计。1文件结构每个C++/C程序通常分为两个文件。一个文件用于保存程序的声明（declaration），称为头文件。另一个文件用于保存程序的实现（implementation），称为定义（definition）

4、文件。C++/C程序的头文件以“.h”为后缀，C程序的定义文件以“.c”为后缀，C++程序的定义文件通常以“.cpp”为后缀（也有一些系统以“.cc”或“.cxx”为后缀）。1.1文件信息声明文件信息声明位于头文件和定义文件的开头（参见示例1-1），主要内容有：（1）版权信息；（2）文件名称，项目代码，摘要，参考文献；（3）当前版本号，作者/修改者，完成日期；（4）版本历史信息；（5）主要函数描述。//////////////////////////////////////////////////////////

5、////////////////////////////////////////////////////////////////////////////////////////////////Copyright(c)2004,DepartmentofMathematics,ZhejiangUniversity//Allrightsreserved.////Filename：filename.h//ProjectCode：Theprojectcodeaboutthisfile//Abstract：Describet

6、hecontentofthisfilesummarily//Reference：......////Version：1.1//Author：thenameofauthor(mender)//Accomplisheddate：September2,2004////Replacedversion:1.0//OriginalAuthor:thenameoforiginalauthor(mender)//Accomplisheddate:September10,2003////Mainfunctions：//Functi

7、on1ReturncodeFunctionname(ParameterExplain)//Function2ReturncodeFunctionname(ParameterExplain)//...//FunctionnReturncodeFunctionname(ParameterExplain)/////////////////////////////////////////////////////////////////////////////////////////////////////////////

8、///////////////////////////////////////////示例1-1文件信息声明☆【规则1.1-1】文件信息声明以两行斜杠开始，以两行斜杠结束，每一行都以两个斜杠开始；☆【规则1.1-2】文件信息声明包含五个部分，各部分之间以一空行间隔；☆【规则1.1-3】在主要函数部分描述了文件所包含的主要函数的声明信息，如果是头文件，这一部分是可以省略的。