c语言编程风格规范

《c语言编程风格规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、CCodingStyleandStandardsC语言编程风格与规范GemwayC语言编程风格与规范CCodingStyleandStandards1概述11.1目的与适用范围11.2程序文档(CodingDocument)11.3编程风格(CodingStyle)12注释规则(CommentingConventions)22.1注释的原则22.2注释的写法23命名规则(NamingConventions)73.1命名的原则73.2函数的命名83.3宏、常量、标识符和标号的命名83.4类型的命名93.5变量的命名94文件体制(File

2、sOrganization)134.1文件命名规则（FileNamingConventions）134.2目录体制(DirectoryOrganization)144.3源代码文件（ProgramFiles）144.3.1文件结构144.3.2一般规范154.3.3表达式书写164.3.4语句格式174.3.5断言设置184.3.6变量初值194.3.7变量置空194.3.8人为制造错误194.3.9统一的函数出口204.3.10错误处理214.3.11范例224.4头文件(HeaderFile)254.4.1头文件结构254.4.2

3、范例254.5工程文件(MAKEFILE)284.6其它文件（OtherFiles）3131CCodingStyleandStandardsC语言编程风格与规范概述目的与适用范围本文件旨在统一本公司的C语言编程风格(CCodingStyle)，制定一系列编程规范(CodingStandards)，使得各项目小组能使用简单、一致、美观的风格进行代码和程序文档的编写，清楚、准确地表达程序员的意图，方便阅读，减少错误，使得程序容易理解、修改、测试和使用。本文件将达到以下目的：增强程序易理解性提高软件可靠性提高软件可维护性提高软件开发效率本文

4、件以MicroSoftWindows3.1Application的程序为范例进行规则描述，其规则适用于其它各种系统下的C语言程序。本文件的使用对象是有经验的程序员，常识性的概念和术语不另外解释。程序文档(CodingDocument)程序文档描述程序数据及过程的组成部分、程序做些什么、程序为什么这样做。程序文档被用来了解一个程序内部结构，了解一个软件系统内的程序与程序之间、程序与操作系统之间、程序与其它软件系统之间的相互作用。程序文档对软件的开发和维护是必不可少的，是一个好的编程风格的重要部分。好的文档应该是简单明了、容易更新、风格一

5、致，同时充分使用编程语言的表达能力，使程序成为自身的文档。程序就是文档(ProgramisDocument)！如果一个程序结构良好，注释完善，程序源代码就可以提供全部必要的程序文档。将程序文档建于代码之中，会使程序的复查和修改、程序文档的更新更为容易。编程风格(CodingStyle)好的编程风格简单、一致、美观，编写的程序结构良好、层次分明、思路清晰，其规则不会复杂得使读者为弄清书写格式而伤脑筋。程序员在编程过程中必须经常考虑到“怎样更好地测试我的程序？”，使得自己的程序结构清晰整齐，易于测试和排错。本规范要求采用下述编程风格和编档

6、技术：程序文档建立在源代码中有选择性的高级注释采用意义明确的名字用缩进格式编写31CCodingStyleandStandardsC语言编程风格与规范编程风格前后一致结构化程序设计统一函数出口运用这些技术可以减少对程序注释的需要，并有助于程序自编文档，此外还可以改善程序文档的可维护性。注释规则(CommentingConventions)注释的原则注释的目的是使读者在思想上形成一个概念，从而正确地理解程序。一般来说，说明程序功能并描述程序各组成部分相互关系的高级注释是最有用的，而逐行解释程序指令如何工作的低级注释则不利于读、写和修改，

7、是不必要的，也是难以维护的。本规范反对使程序代码由于大量冗长的注释而凌乱不堪，注释与代码的行数比在0.8：1时比较合适。程序员在写注释时，不是逐行地去弄懂某个程序，而是将指令归并，形成更高一级且更易理解的组合：块(Block)（如：用以实现“在报表上画出标题”这段程序）。在源代码中，注释应放在每一块之前，以说明该程序块的作用。程序块的具体操作不用在注释中描述，由程序中有意义的命名来反应，可以通过阅读代码来了解。指令注释应该尽量少用。不需要对每条程序指令、每一控制过程、每个决策点都作出注释。指令注释只用于特殊情况，如说明某个少见的、复杂

8、的或者经过优化的算法，指出关键的操作、容易出错的程序段以及有可能混淆之处。对于主要的数据结构、变量，则应不厌其烦地予以注释。注释的写法函数描述在每个函数之间必须有一段函数描述，描述的每个部分由标识字开头，意义分别如下：@