C语言编程范.docVIP

编码格式 一、注释 注释是源程序中非常重要的一部分，一般来讲，注释量在源程序中的比重要达到15%以上。 注释的原则是有助于对程序的阅读理解，所以注释语言必须准确，易懂、简洁。 1、模块（C）文件描述 *********************************************** Module Name: // 模块的名字 Module Date: // 生成日期 Module Author: // 作者 Description: // 模块描述，详细说明本程序文件完成的主要功能 ********************************************** /*————————Includes—————————*/ //包含的头文件 /*————————Local Variables———————*/ //本地变量 //要使用的一些数据结构 。。。 2、头文件描述 头文件一般包括数据结构的定义，函数原形的说明、宏定义等，不能包含函数体和变量实体。 3、函数描述 *********************************************** Function Name: // 函数的名字 Inputs: // 输入参数 Outputs: // 输出参数 Notes: // 本函数调用的函数清单及其他 ********************************************** 二、排版 2.1 用缩进格式书写代码 ? 函数或过程的开始、结构定义及循环、判断等语句中的代码都要采用缩进； ? 缩进的空格数为4个； ? 使用空格键，不使用TAB键； ? 程序块的分界符（‘{’和‘}’）应各独占一行。 例： for(i = 0; i STUDENT_NUM; i++ ) { //累加计算总分 if(fScore[i] 0) { //遇到负分,记为0分 total_score += fScore[i]; } } 2.2 其他书写格式 2.2.1 长语句 ? 较长的语句（多于80字符）要分成多行书写； ? 长表达式要在低优先级操作符处划分新行，操作符放在新行之首； ? 划分出的新行要进行适当的缩进，使排版整齐，语句可读； ? 不允许把多个短语句写在一行中，即一行只写一条语句。 2.2.2 空行和空格的使用 相对独立的程序块之间、变量定义之后语句开始以前必须加空行 ； 逗号、分号只在后面加空格 ； 比较操作符、赋值操作符、算术操作符、逻辑操作符、位域操作符等双目操作符的前后加空格； “!”、“~”、“++”、“--”、“”等单目操作符前后不加空格； -、.前后不加空格 。 例： void Func1(int x, int y, int z); // 良好的风格 void Func1 (int x,int y,int z); // 不良的风格 x = a b ? a : b; // 良好的风格 x=ab?a:b; // 不好的风格 int *x = y; // 良好的风格 int * x = y; // 不良的风格 三、表达式和基本语句 3.1 运算表达式 ? 不要编写太复杂的复合表达式； 例如： i = a = b c d c + f = g + h; //复合表达式过于复杂 不要有多用途的复合表达式； 例如： d = (a = b + c) + r ; //应拆分为两个语句： a = b + c; d = a + r; ? 如果代码行中的运算符比较多，用括号确定表达式的操作顺序，避免 使用默认的优先级。 例如： if(a | b a c) //不良的风格 if((