huawei代码书写规范
69页1、目录1 排版 6 2 注释 11 3 标识符命名 18 4 可读性 20 5 变量、结构 22 6 函数、过程 28 7 可测性 36 8 程序效率 40 9 质量保证 44 10 代码编辑、编译、审查 50 11 代码测试、维护 52 12 宏 531 排版 11:程序块要采用缩进风格编写,缩进的空格数为4 个。说明:对于由开发工具自动生成的代码可以有不一致。12:相对独立的程序块之间、变量说明之后必须加空行。示例:如下例子不符合规范。if (!valid_ni(ni). / program coderepssn_ind = ssn_dataindex.repssn_indexrepssn_ni= ssn_dataindex.ni应如下书写if (!valid_ni(ni). / program coderepssn_ind = ssn_dataindex.repssn_indexrepssn_ni= ssn_dataindex.ni13:较长的语句(80 字符)要分成多行书写,长表达式要在低优先级操作符处划分新行, 操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句
2、可读。示例:perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL )act_task_tableframe_id * STAT_TASK_CHECK_NUMBER + index.occupied= stat_poiindex.occupiedact_task_tabletaskno.duration_true_or_false= SYS_get_sccp_statistic_state( stat_item )report_or_not_flag = (taskno ) ,后不应 加空格。说明:采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格, 如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不 必加空格,因为在 C/C+语言中括号已经是最清晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给 操 作符留空格时不要连续留
3、两个以上空格。示例:(1) 逗号、分号只在后面加空格。int a, b, c(2)比较操作符, 赋值操作符“=“、 “+=“,算术操作符“+“、“%“,逻辑操作符“&“、“&“,位 域操作符“= MAX_TIME_VALUE)a = b + ca *= 2a = b 2(3)“!“、“、“+“、“、“&“(地址运算符)等单目操作符前后不加空格。*p = a/ 内容操作“*“与内容之间flag = !isEmpty / 非操作“!“与内容之间p = &mem/ 地址操作“&“ 与内容之间i+/ “+“,“与内容之间(4)“、“.“前后不加空格。pid = pid/ “指针前后不加空格(5) if、for、while、switch 等与后面的括号间应加空格,使if 等关键字更为突出、明显。if (a = b & c d)11:一行程序以小于80 字符为宜,不要写得过长。2 注释 21:一般情况下,源程序有效注释量必须在20以上。说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能 太少,注释语言必须准确、易懂、简洁。22:说明性文件(如头文件.h 文件、.inc
4、 文件、.def 文件、编译说明文件.cfg 等)头部应进 行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件 的 关系、修改日志等,头文件的注释中还应有函数功能简要说明。示例:下面这段头文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要 包 含在内。/*Copyright (C), 19881999, Huawei Tech. Co., Ltd.File name:/ 文件名Author:Version:Date: / 作者、版本及完成日期Description:/ 用于详细说明此程序文件完成的主要功能,与其他模块/ 或函数的接口,输出值、取值范围、含义及参数间的控/ 制、顺序、独立或依赖等关系Others:/ 其它内容的说明Function List:/ 主要函数列表,每条记录应包括函数名及功能简要说明1. .History:/ 修改历史记录列表,每条修改记录应包括修改日期、修改/ 者及修改内容简述1. Date:Author:Modification:2. .*/23:源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块目的/
《huawei代码书写规范》由会员n****分享,可在线阅读,更多相关《huawei代码书写规范》请在金锄头文库上搜索。
项目二财务管理价值观念
山东省安全生产风险分级管控与隐患排查治理信息化系统交流材料-2018.9.26
人教版高中地理必修3第一章地理环境与区域发展第二节《地理信息技术在区域地理环境研究中的应用》
第三章2房地产抵押贷款-固定利率抵押贷款
第八章工程质量法律制度
第25讲家庭电路与安全用电
餐厅点餐系统项目
项目7水箱水位控制
框架完整个人年度工作总结范文模板
科目名称-国土交通省
金融工程09课件
高校自主招生之结构化面试
房地产私募股权投资基金(PE)专题研究.
房地产基础知识培训2012
第一章食品检测技术基础知识
第10章网站设计与建设综合实例
第5章尝试迷人的机器人项目机器人灭火项目
自考英语二unit3
企业人力资源管理师第六章劳动法与劳动关系管理
第三章市场营销宏观环境分析
2023-11-21 16页
2023-11-21 9页
2023-11-21 5页
2023-10-09 12页
2023-09-14 4页
2023-09-14 10页
2023-09-14 15页
2023-09-14 8页
2023-09-14 14页
2023-09-13 191页