c语言编程规范.docx

c语言编程规范.docxDKBA
***有限公司内部技术规范
DKBA 2826-
C语言编程规范
HUAWEI
2011年5月 9日发布
2011 年5月9日实施
***有限公司
Huawei Technologies Co., Ltd.
版权所有侵权必究
All rights reserved
密级：confidentiality level
* V
DKBA 2826-
修订声明 Revision declaration
本规范拟制与解释部门：
本规范的相关系列规范或文件: 相关国际规范或文件一致性：
替代或作废的其它规范或文件: 相关规范或文件的相互关系：
规范号
主要起草部门专家
主要评审部门专家
修订情况
-
PSST质量部： 郭曙光00121837
PSST质量部：
李重霄00117374
网络：
郭永生00120218
张伟 00118807
核心网：
周灿 00056781
张进柏00120359
王晶 00041937
中研：
陈艺彪00036913
张建保00116237
IP开发部：
无线：
薛治 00038309
苏光牛00118740
核心网：
郑铭 00118617
张小林00058208
陶永祥00120482
王德喜00040674
软件公司：
李明胜00042021
周代兵00120359
软件公司：
刘心红00118478
文滔00119601
朱文琦00172539
无线：
网络：
刘爱华00162172
王玎 00168059
中研：
黄维东49827
谭洪 00162654
IP开发部： 饶远 00152313
目 录 Table of Contents
0规范制订说明 5
前言 5
代码总体原则 5
规范实施、解释 6
术语定义 6
1头文件 6
2函数 12
3标识符命名与定义 21
通用命名规则 21
文件命名规则 23
变量命名规则 23
函数命名规则 24
宏的命名规则 24
4变量 24
5宏、常量 28
6质量保证 31
7程序效率 36
8注释 39
9排版与格式 43
表达式 46
代码编辑、编译 49
可测性 50
安全性 51
字符串操作安全 51
整数安全 52
格式化输出安全 55
文件I/O安全 57
其它 59
单元测试 59
可移植性 60
业界编程规范 60
C语言编程规范
范围：
本规范适用于公司内使用 c语言编码的所有软件。本规范自发布之日起生效，以后新编写的和修改的 代码应遵守本规范。
简介：
本规范制定了编写 C 语言程序的基本原则、规则和建议。从代码的清晰、简洁、可测试、安全、程序效 率、可移植各个方面对 C 语言编程作岀了具体指导。
0规范制订说明

为提高产品代码质量，指导广大软件开发人员编写岀简洁、可维护、可靠、可测试、高效、可移植的 代码，编程规范修订工作组分析、总结了我司的各种典型编码问题，并参考了业界编程规范近年来的 成果，重新对我司1999年版编程规范进行了梳理、优化、刷新，编写了本规范。
本规范将分为完整版和精简版，完整版将包括更多的样例、规范的解释以及参考材料 （what & why），
而精简版将只包含规则部分 （what）以便查阅。
在本规范的最后，列岀了一些业界比较优秀的编程规范，作为延伸阅读参考材料。

1、 清晰第一
清晰性是易于维护、易于重构的程序必需具备的特征。 代码首先是给人读的，好的代码应当可以像文
章一样发声朗诵出来。
目前软件维护期成本占整个生命周期成本的 40%〜90%根据业界经验，维护期变更代码的成本， 小型系
统是开发期的5倍，大型系统（100万行代码以上）可以达到 100倍。业界的调查指岀，开发组平均大约 一半的人力用于弥补过去的错误，而不是添加新的功能来帮助公司提高竞争力。
"程序必须为阅读它的人而编写，只是顺便用于机器执行。” Harold Abelso n 和Gerald Jay
Suss