c&c++语言编程规范

《c&c++语言编程规范》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、XXXXXX®C/C++语言编程规范文件状态：[]草稿[]正在修改[]正式发布文件标识：XXX当前版本：作者：完成日期：XXXhttp://www.XXX.comÓXXX2010Page27of28XXXI.文档控制1)文档更新记录日期更新人版本备注2)文档审核记录日期审核人职务备注3)文档发行范围分发单位说明ÓXXX2010Page27of28XXX目录1.引言51.1编写目的51.2内容51.3预期读者51.4参考资料51.4缩写和术语52．命名规则63．文件组织83.1头文件的结构83.2内部包含卫哨83.3源文件的结构83.

2、4头文件包含顺序93.5外部包含卫哨93.6目录结构103.7其它原则104．代码版式114.1空行114.2代码行114.3代码行内的空格124.4对齐与缩进124.5长行拆分134.6修饰符的位置144.7注释风格145编程规则和建议165.1表达式165.2声明和定义175.3整数数据类型及操作175.4字符操作185.5浮点型185.6常量195.7指针195.8数组205.9函数205.10控制语句215.11内存使用215.12错误处理215.13断言215.14类225.15结构成员对齐方式225.16连接规范245.

3、17函数调用规范255.18通用规则和建议256．附件276.1头文件样式模板27ÓXXX2010Page27of28XXX6.2源文件样式模板276.3函数头注释模版28ÓXXX2010Page27of28XXX1.引言1.1编写目的本文档的目的是为XXX公司使用C/C++语言进行软件开发提供编程规范指南。声明：（1）本规范针对的C++语言是指ISO/IEC14882:1998标准规定的C++语言规范。（2）本规范对编程过程中使用的第三方程序库不做任何假设，第三方程序库仍然保留其固有的编程风格和规范。规则0：不存在绝对的编程规范和

4、规则；规范和规则不应有正确与错误之分，只有适合与不适合、好与不好或者通用与不通用的区别。规范和规则强调的是一致性，这个一致性有三层含义：①每个开发人员编写的代码要前后一致；②每个项目组采用统一的编程规范；③全公司各项目组都采用统一的编程规范。1.2内容编程规范不仅仅包含编程风格，更重要的是指导如何正确运用语言提供的机制，提供常用的惯用法，改善编程效率和程序性能的方法和技巧，以及编程的禁区。大部分的内容可以用“规则”或“规范”的形式固定下来，但是也有很多内容只能以“建议”的形式呈现。1.3预期读者本文档的主要读者包括：-开发设计人员和

5、程序员-项目管理员-软件质量保证人员1.4参考资料[1]<>[2]<>[3]<>[4]<>1.5缩写和术语标识符（identifier）指C/C++中的一个变量、常量、宏、函数或类型的名字定义（define）提供一个程序元素或实体在程序中的唯一描述声明（declare）把一个名字引入

6、一个程序或者一个作用域，以向编译器表明该名字的存在性及其作用域作用域（scope）一个名字可以被引用的程序范围。C++有6种作用域：全局，文件，程序块，函数体，函数原型，类，名字空间编译单元源文件及其递归包含的所有头文件共同编译生成的目标模块(.obj/.o)，一个源文件是一个最小的编译单元ÓXXX2010Page27of28XXX2．命名规则类别规则示例共性规则-所有标识符的名字应当直观且可以顺利拼读，可望文生义，不必进行解码（即自说明的，几乎不需要专门的注释）；-同一个作用域中不要出现仅靠大小写来区分的相似标识符，虽然C/C++

7、是大小写相关的；-在设计中，所有模块(namespace)、函数、变量、宏、类型等的名称均由字母、数字和单下划线组成，尽量少使用数字（除非语义如此），标识符的头部和尾部一般不要使用下划线和数字；-所有的名称均应具有实际含义，应体现实际用途，不应该包含那些不被普遍接受和认同的缩略语；-尽量不要出现局部变量和全局变量同名的现象，虽然两者作用域不同而不会发生语法错误，但是会使人误解并可能引起语义错误；-变量的名字应该使用“名词+名词”或“形容词+名词”的格式来命名；-函数名建议使用“动词”或“动词+名词”的格式来命名，并表明自己的功能；-

8、使用正确的反义词来命名具有相反意义的变量或相反动作的函数等；-标识符的长度应该符合“min-length&max-information”原则；-避免使用过度缩写和简写；currentValuetimeToStarttimeToSto