随笔分类 - 软件编程规范
该编程规范为华为软件编程总则，侵删。
摘要：1.用宏定义时，要使用完备的括号。 示例：如下定义的宏都存在一定的风险。 正确的定义应为： 2.将宏所定义的多条表达式放在大括号里。 示例：下面的语句只有宏的第一条表达式被执行。为了说明问题，for 语句的书写稍不符规范。 正确的写法应为： 3.使用宏时，不允许参数发生变化。 示例：如下用法可能导致
阅读全文
摘要：1.单元测试要求至少达到语句覆盖。 2.单元测试开始要跟踪到每一条语句，并观察数据流及变量的变化。 3.清理、整理或优化后的代码要经审查及测试。 4.代码版本升级要经过严格测试。 5.使用工具软件对代码版本进行维护。 6.正式版本上软件任何修改都应有详细的文档记录。 7.发现错误要立刻修改，并且记录
阅读全文
摘要：1.打开编译器的所有告警开关对程序进行编译。 2.在产品软件（项目组）中，要统一编译开关选项。 3.通过代码走读及审查方式对代码进行检查。 说明：代码走读主要是对程序的编程风格如注释、命名等以及编程时易出错的内容进行检查，可由开发人员自己或开发人员交叉的方式进行；代码审查主要是对程序实现的功能及程序
阅读全文
摘要：1.在软件设计过程中构筑软件质量。 2.代码质量保证优先原则。 （1）正确性，指程序要实现设计要求的功能。 （2）稳定性、安全性，指程序稳定、可靠、安全。 （3）可测试性，指程序要具有良好的可测试性。 （4）规范/可读性，指程序书写风格、命名规则等要符合规范。 （5）全局效率，指软件系统的整体效率。
阅读全文
摘要：1.编程时要经常注意代码效率。 说明：代码效率分为全局效率、局部效率、时间效率及空间效率。全局效率是站在整个系统的角度上的系统效率；局部效率是站在模块或函数角度上的效率；时间效率是程序处理输入任务所需的时间长短；空间效率是程序所需内存空间，如机器代码空间大小、数据空间大小、栈空间大小等。 2.在保证
阅读全文
摘要：1.在同一项目组或产品组内，要有一套统一的为集成测试与系统联调准备的调测开关及相 应打印函数，并且要有详细的说明。 说明：本规则是针对项目组或产品组的。 2.在同一组或产品组内，调测打印处的信息串的格式要有统一的形式。信息串中至少要有所在模块名（或源文件名）及行号。 说明：统一的调测信息格式便于集成
阅读全文
摘要：1.对所调用函数的错误返回码要仔细、全面地处理。 2.明确函数功能，精确（而不是近似）地实现函数设计。 3.编写可充入函数时，应注意局部变量的使用（如编写C/C++语言的可重入函数时，应使用auto即缺省态局部变量或寄存器变量）。 说明：编写C/C++语言可重入函数时，不应使用static局部变量，
阅读全文
摘要：1.去掉没必要的公共变量。 说明：公共变量时增大模块间耦合的原因之一，故应减少没必要的公共变量以降低模块间的耦合度。 2.仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。 说明：在对变量声明的同时，应对其含义、作用、及取值范围进行注释说明，同时若有必要还应说明与其他变量的关系。 3.
阅读全文
摘要：1.注意运算符优先级，并用括号明确表达式的操作顺序，避免使用默认优先级 说明：防止阅读程序时造成误解，防止因默认的优先级与涉及思想不符而导致程序出错。 示例：下列语句中的表达式 如果书写为 由于 （1）（2）不会出错，但语句理解不易； (3)造成了判断条件出错。 2.避免使用不易理解的数字，用有意义
阅读全文
摘要：1.标识符的命令要清晰、明了，有明确含义，同时使用完整的单词或大家都能理解的缩写，避免使人产生误解。 说明：较短的单词可以通过去掉元音来形成缩写；较长的单词可取单词的头几个字母形成缩写；一些单词有大家公认的缩写。 示例：以下的单词缩写能够被大家基本认可。 temp 可缩写为 tmp ； flag 可
阅读全文
摘要：1.一般情况下，源程序有效注释量必须在20%以上。 说明：注释的原则是有助于程序的阅读理解，在改加的地方都加了，注释不能太多也不能太少，注释语言必须准确、易懂、简洁。 2.说明性文件（比如头文件.h文件、.inc文件、.def文件、编译文件.cfg等）头部应该进行注释，注释必须列出：版权说明、版本号
阅读全文
摘要：1. 程序块要采用缩进风格编写，缩进的空格数位4。 说明：对于由开发工具自动生成的代码可以由不一致。 2. 相对独立的程序块之间、变量说明之后必须加空格。 实例：如下例子不符合规范 应如下书写： 3. 较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，
阅读全文