测控研究生编程规范

《测控研究生编程规范》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、北化测控研究生C语言编程规范范围：本规范适用于北化测控研究所内部使用c语言编写的程序，其它语言也町类比使川。本规范自修订完成后开始纶效，以后新编写的和修改的代码应遵守木规范。简介：针对实验室同仁编写程序的不规范性、风格各异，给后续学习带來很人困难。根据实验室于涛老师的要求，制定了木实验室内部的编写c语言程序的基木原则、规则和建议。从代码的淸晰、简洁、可测试、安全、程序效率、可移植各个方面对c语言编程作出了具体指导。在制定过程中主要参考了《华为技术有限公司c语言编程规范》和《GoogleC++编程规范》。第一章规范制定说明1.1前言为提高产

2、品代码质量，指导实验室同学编写出简洁、可维护、可靠、可测试、高效、可移植的代码，编程规范修订工作组分析、总结了各种典型编码问题，并参考了业界编程规范近年来的成果，在对其它编程规范进行了梳理、优化、刷新，编写了本规范。1.2代码总体原则1、清晰第一清晰性是易于维护、易于重构的程序必需具备的特征。代码首先是给人读的，好的代码应当可以像文章一样发声朗诵出来。目前软件维护期成本占整个生命周期成本的40%〜90%。根据业界经验，维护期变更代码的成本，小型系统是开发期的5倍，大型系统（100万行代码以上）可以达到100倍。业界的调杳指出，开发组平均人

3、约一半的人力用于弥补过去的错课，而不是添加新的功能来帮助公司提高竞争力。“程序必须为阅读它的人而编写，只是顺便用于机器执行。”一一HaroldAbelson“编写程序应该以人为本，计算机第二。”——SteveMcConnell2、简洁为美简洁就是易于理解并且易于实现。代码越长越难以看懂，也就越容易在修改时引入错误。写的代码越多，意味着出错的地方越多，也就意味着代码的町靠性越低。因此，我们提倡大家通过编写简洁明了的代码來提升代码可靠性。废弃的代码要及时清除，重复代码应该尽可能提炼成函数。3、选择合适的风格，与代码原有风格保持一致产品所冇人共

4、同分享同一种风格所带來的好处，远远超出为了统一而付出的代价。在公司已有编码规范的指导F,审慎地编排代码以使代码尽可能清晰，是一项非常重要的技能。1.3术语规范原则：编程时必须坚持的指导思想。规则：编程时强制必须遵导的约定。建议：编程时必须加以考虑的约定。说明：对此原则/规则/建议进行必要的解释。第二章头文件对于C语言來说，头文件的设计体现了大部分的系统设计。不合理的头文件布局是编译时间过长的根因，不合理的头文件实际上既是不合理的设计。合理的头文件划分体现了系统设计的思想，但是从编程规范的角度看，仍然有一些通用的方法，用来合理规划头文件。下

5、面介绍的一些方法，对于合理规划头文件会冇一定的帮助。原则2・1头文件中适合放置接口的声明，不适合放置实现头文件是模块(Module)或单元(Unit)的对外接口。头文件中应放置对外部的声明，如对外提供的两数声明、宏定义、类型定义等。内部使用的函数(相当于类的私有方法)声明不应放在头文件中。内部使用的宏、枚举、结构定义不应放入头文件小。变量定义不应放在头文件中，应放在.c文件中。变量的声明尽最不要放在头文件屮，亦即尽最不要使用全局变最作为接II。变量是模块或单元的内部实现细节，不应通过在头文件中声明的方式直接暴露给外部，应通过函数接口的方式

6、进行对外暴露。即使必须使用全局变呆，也只应当在・c屮定义全局变量，在.h屮仅声明变量为全局的。原则2.2头文件应当职责单一头文件过于复杂，依赖过于复杂是导致编译时间过长的主要原因。很多现有代码中头文件过大，职责过多，再加上循环依赖的问题，可能导致为了在.c中使用一个宏，而包含十儿个头文件。原则2.3头文件应向稳定的方向包含头文件的包含关系是一种依赖，一般來说，应当让不稳定的模块依赖稳定的模块，从而当不稳定的模块发生变化时，不会影响(编译)稳定的模块。规则1.1禁止头文件循环依赖规则1・2.c/.h文件禁止包含用不到的头文件规则1.3头文件

7、应当自包含简单的说，自包含就是任意一个头文件均可独立编译。规则1・4总是编写内部^include保护符（ttdefine保护）多次包含一个头文件可以通过认真的设计来避免。如果不能做到这一点，就需耍采取阻止头文件内容被包含多于一次的机制。规则1・5禁止在头文件中定义变量在头文件中定义变最，将会由于头文件被其他.c文件包含而导致变最重复定义。规则1.6只能通过包含头文件的方式使用其他・c提供的接口，禁止在.c中通过extern的方式使用外部函数接口、变量。建议1.1一个模块通常包含多个.c文件，建议放在同一个目录下，目录名即为模块名。为方便外

8、部使用者，建议每一个模块提供一个・h,文件名为目录名。需要注意的是，这个・h并不是简单的包含所冇内部的・h,它是为了模块使用者的方便,对外整体捉供的模块接口。建议1.2如果一个模块包含多个子模