C语言编程规范.pptVIP

C语言编程规范 高质量C++/C编程指南 ----作者:林锐 崔文盛 200792168 0726班 C编程规范的意义 清晰、易懂 准确、严密 高效率、低消耗 美观 总体分析 合理清晰的排版 适当准确的注释 清晰准确的标识符命名 较高的可读性 合理的函数定义和调用 合理清晰的排版 在代码的版面上多下点功夫，让代码清晰，美观而易懂。 多去尝试好的建议，养成良好的习惯。 较长的语句要分多行书写 不好的例子： report_or_not_flag = ((taskno MAX_ACT_NUMBER)? (n7stat_stat_ivalid; n7stat_str_compare((BYTE *) stat_object,(BYTE *) (act_table[taskno].stat_object),?????????????????? 较长的语句要分多行书写 规范的例子： report_or_not_flag = ((taskno MAX_ACT_NUMBER)?????????????????????? (n7stat_stat_item_valid (stat_item))?????????????????????? (act_table[taskno].result_data != 0)); n7stat_str_compare((BYTE *) stat_object,?????????????????? (BYTE *) (act_table[taskno].stat_object),?????????????????? sizeof (_STAT_OBJECT)); 结构语句排版 if、for、do、while、case、switch、default等语句自占一行。程序块的分界符要正确分布。 不规范的例子 if (pUserCR == NULL) return; —————————————————— while (...) { // program } 规范的例子 if (pUserCR == NULL) { return； } ———————————————————— while (...) 　 　　 { ??? 　 // program code 　　 } 一些细节 程序模块要采用缩进风格编写。 相对独立的程序块之间要加空行。 不要把多个短语句写在一行中。 weight=20.3; volume=6.7; weight=20.3; volume=6.7; 适当准确的注释 在头文件，源文件和函数头部进行说明性注释： 一般格式： /****************************************** 说明性文字 ******************************************/ 一般标准的源文件注释 一般标准的函数头部注释 结束标记注释 在程序块的结束行右方加注释标记。 if (...){????// program code ????while (index MAX_INDEX)????{????????// program code????} /* end of while (index MAX_INDEX) */ // 指明该条while语句结束} /* end of??if (...)*/ // 指明是哪条if语句结束 其它细节 边写代码边注释。 注释的内容要清楚、明了，含义准确。 数据结构声明(包括数组、结构、类、枚举等) 。 清晰准确的标识符命名 使用完整单词或者大家可以理解的缩写。 尽量避免名字中出现连续的数字。 不规范的命名 int i, j, k; double value1, value2, value3; 规范的命名 int student_num, teacher_num, class_num; double length, width, hight; 别的要注意的 不要使用关键字的大小写变形。 int Int, Long; int integer, integer_long; 函数名应当采用合适的前缀。 所有的常量统一使用大写。 较高的可读性 尽量不要使用技巧性很高但可读性很差的语句。 * stat_poi ++ += 1; * ++ stat_poi += 1; *stat_poi += 1; stat_poi++;???? // 此二语句功能相当于 //“ *stat_po