1、编程规范,1、程序员花更多的时间在调试、维护和升级已有代码上，而不是编写新的代码；2、程序最重要的是正确性，其次是可维护性，最后才是效率；3、学习如何写优美的程序与学习如何正确地编写代码同样重要；4、让程序尽量简单易懂，即使违背了某些规则也无关紧要；5、一个运行正常但没有注释的程序如同一个等待爆炸的定时炸弹，因为早晚会有人修改或升级这个程序；6、好风格应该成为一种习惯。如果你在开始写代码时就关心风格问题，如果你花时间去审视和改进它，你将会逐渐养成一种好的编程习惯。一旦这种习惯变成自动的东西，你的潜意识就会帮你照料许多细节问题，甚至你在工作压力下写出的代码也会更好。,关于编程规范的几个原则,fl
2、oat b, c10;void abc(void)float zongfen = 0; int d; for( d = 0; d 0)zongfen += cb;b = zongfen /10;这段程序在做什么？ 这段程序是否有错误？ 这程序中存在哪些不良的书写风格？它们可能会引起什么后果？,程序实例,float b, c10; void abc(void) float zongfen = 0; int d; for( d = 0; d 0) zongfen += cb; b = zongfen /10;,有了哪些改进？ 你认为还有什么地方需要改进？,一、标识符,标识符的命名要清晰、明了，有明
3、确含义。使用完整的单词或大家基本可以理解的缩写，避免使人产生误解。 标识符应当采用英文单词或其组合，切忌使用汉语拼音来命名。坏的命名: int a / Age1 / XueshengAge; 好的命名: int StudentAge; 1.1 变量名 1.1.1 不同作用域变量的命名局部变量以小写字母命名；全局变量以首字母大写方式命名（骆驼式）；定义类型和宏定义常数以大写字母命名；变量的作用域越大，它的名字所带有的信息就应该越多。局部变量： int student_age;全局变量： int StudentAge;宏定义常数：#define STUDENT_NUM 10 类型定义： typed
4、ef INT16S int;,1.1.2 不同类型变量的命名（匈牙利命名法）匈牙利命名法是一种命名约定。匈牙利命名法把变量的类型 (或者它的预期使用) 等信息编码在变量名中。一些常用的匈牙利命名法前缀 数据类型 前缀 例子char c cInChar unsigned char uc ucOutCharint i iReturnValueunsigned int ui uiControlWordlong l lNumRecsfloat f fLengthdouble d dArea,一、标识符,1.1.3 指针变量的命名对于指针的定义，名称大小写根据指针为全局/局部变量来定，但指针名必须以小写
5、的“p”开头。 如：int *pDay; /全局指针int *pday; /局部指针int *ppDay; /指针的指针1.1.4 在某一模块中使用的变量，变量名的开始需有模块名。 如：模块 KEY.C 中的变量：int iKeyNum;int iKeyNumBuff10;,一、标识符,一、标识符,1.2 函数名函数名的命名应象全局变量一样采用首字母大写方式（骆驼式）。函数名的开始应以“ 模块名_ ”的格式注明函数所属模块。例如：（1）KEY.C模块的函数void KEY_Init(void);void KEY_StartScan(void);void KEY_StopScan(void);（
6、2）TMR.C模块的函数void TMR_Init(void);void TMR_Start(TMR_ID tmr);void TMR_Stop(TMR_ID tmr);,二、排版,名字的合理选择可以帮助理解程序。同样，也应该以尽可能一目了然的形式书写语句。这就像保持书桌整洁可以使你容易找到东西一样。2.1 用缩进格式书写代码函数或过程的开始、结构定义及循环、判断等语句中的代码都要采用缩进；缩进的空格数为4个；使用空格键，不使用TAB键；程序块的分界符（和）应各独占一行。例： for(i = 0; i 0) /遇到负分,记为0分total_score += fScorei;,二、排版,2.2
7、其他书写格式 2.2.1 长语句较长的语句（多于80字符）要分成多行书写；长表达式要在低优先级操作符处划分新行，操作符放在新行之首；划分出的新行要进行适当的缩进，使排版整齐，语句可读；不允许把多个短语句写在一行中，即一行只写一条语句。 例： 修改前： MeasData.TransTdir=TransTdir*SetData.Filter+TransTdir*(1-SetData.Filter); 修改后： MeasData.TransTdir = TransTdir * SetData.Filter+ TransTdir * (1 - SetData.Filter);,二、排版,2.2.2 空
8、行和空格的使用相对独立的程序块之间、变量定义之后语句开始以前必须加空行 ；逗号、分号只在后面加空格 ；比较操作符、赋值操作符、算术操作符、逻辑操作符、位域操作符等双目操作符的前后加空格；“!”、“”、“+”、“-”、“ / 不良的风格,三、表达式和基本语句,3.1 运算表达式不要编写太复杂的复合表达式； 例如： i = a = b 如果代码行中的运算符比较多，用括号确定表达式的操作顺序，避免 使用默认的优先级。 例如： if(a | b & a & c) /不良的风格 if(a | b) & (a & c) /良好的风格注意:只需记住加减运算的优先级低于乘除运算，其它地方一律加上括号。,三、表
9、达式和基本语句,3.2 if 语句 3.2.1 布尔变量与零值比较不可将布尔变量直接与TRUE、FALSE 或者1、0 进行比较。根据布尔类型的语义，零值为“假”（记为FALSE），任何非零值都是“真”（记为TRUE）。TRUE的值究竟是什么并没有统一的标准。例如Visual C+ 将TRUE 定义为1，而Visual Basic 则将TRUE 定义为-1。例：假设布尔变量名字为flag，它与零值比较的标准if 语句如下： if (flag) / 表示flag为真时满足条件 if (!flag) / 表示flag为假时满足条件其它的用法都属于不良风格，例如： if (flag = TRUE)
10、if (flag = 1 ) if (flag = FALSE) if (flag = 0),3.2.2 整型变量与零值比较应当将整型变量用“=”或“！=”直接与0比较。 例：假设整型变量为value，它与零值比较的标准if 语句如下： if (value = 0) if (value != 0) 不可模仿布尔变量的风格而写成 if (value) / 会让人误解 value 是布尔变量 if (!value)3.2.3 浮点变量与零值比较不可将浮点变量用“=”或“！=”与任何数字比较。 千万要留意，无论float 还是double 类型变量，都有精度限制。所以一定要避免将浮点变量用“=”或“
11、！=”与数字比较，应该设法转化成“=”或“=-EPSINON) & (x=EPSINON) /EPSINON 是精度,三、表达式和基本语句,三、表达式和基本语句,3.2.3 对if 语句的补充说明有时候我们可能会看到这样古怪的格式：if (NULL = = p)不是程序写错了，是有经验的程序员为了防止将 if (p = = NULL) 误写成 if (p = NULL)，而有意把p 和NULL 颠倒。编译器认为 if (p = NULL) 是合法的，但是会指出 if (NULL = p)是错误的，因为NULL不能被赋值。,三、表达式和基本语句,3.3 switch 语句,每个case 语句的结
12、尾不要忘了加break，否则将导致多个分支重叠 （除非有意使多个分支重叠）不要忘记最后那个default 分支。即使程序真的不需要default 处理， 也应该保留语句 default : break; 这样做并非多此一举，而是为了防止别人误以为你忘了default 处理。switch 语句的标准格式是： switch (variable) case value1 : break;case value2 : break;default : break; ,四、常量,这是一个根据LCD的列来计算像素X坐标的函数：INT16U LCD_GetStX(INT8U col) INT16U x;if(c
13、ol 29)col = 29; #if LCD_MODE = _VGAx = 150 + (INT16U)col * 8; #elifx = (INT16U)col * 8; #endifreturn(x); 代码中的数（29，8，150）都是什么意义？ 这些神秘的数给程序的阅读和维护增加了很大的难度。,#define LCD_MAX_COL 29 /LCD最大列数 #define LCD_START_X 150 /LCD起始X坐标 #define LCD_COL_WIDTH 8 /LCD列宽INT16U LCD_GetStX(INT8U col) INT16U x;if(col LCD_MA
14、X_COL )col = LCD_MAX_COL ; #if LCD_MODE = _VGAx = LCD_START_X + (INT16U)col * LCD_COL_WIDTH ; #elifx = (INT16U)col * LCD_COL_WIDTH ; #endifreturn(x); ,四、常量,四、常量,4.1 为什么要用常量 如果不使用常量，直接在程序中填写数字或字符串，将会有什么麻烦？ （1） 程序的可读性（可理解性）变差。程序员自己会忘记那些数字或字符串是什么意思，用户则更加不知它们从何处来、表示什么。 （2） 在程序的很多地方输入同样的数字或字符串，难保不发生书写错误。
15、 （3） 如果要修改数字或字符串，则会在很多地方改动，既麻烦又容易出错。4.2 定义常量的方法 （1）#define 宏定义 （2）const 常量 （3）enum 枚举,4.3 #define 宏定义使用最广泛，如：#define MAX_TEACHER 100 缺点：宏定义的常量没有类型，只进行字符替换，没有类型安全检查，并且在字符替换可能会产生意料不到的错误。4.4 const 常量 如：const int MAX_STUDENT = 100; 优点：const 常量有数据类型，而宏常量没有数据类型。编译器可以对前者进行类型安全检查。 缺点： const 常量无法在数组定义时作为数组长度
16、。如：float StudentHeightMAX_STUDENT; /错误,四、常量,4.5 枚举enumRED, BLUE, GREEN, YELLOW, WHITE, BLACK, COLOR_NUM; 优点: (1) 适合一次定义批量常数，尤其是在数值连续时尤为方便；(2) 枚举常量可以作为数组长度，如：float BallSizeCOLOR_NUM; 缺点：不能定义除整型外的其他类型常量，如float和double。,四、常量,一个运行正常但没有注释的程序如同一个等待爆炸的定时炸弹；而在有注释，但注释不正确时，炸弹的当量更大。注释应当准确、易懂，防止注释有二义性。错误的注释不但无益反
17、而有害。5.1 注释的基本概念 C 语言的注释符为“/*/”。C+语言中，程序块的注释常采用“/*/”，行注释一般采用“/”。注释通常用于： （1）版本、版权声明； （2）函数接口说明； （3）重要的代码行或段落提示。 虽然注释有助于理解代码，但注意不可过多地使用注释。,五、注释,五、注释,5.2 注释的准确性边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释要删除。注释应当准确、易懂，防止注释有二义性。错误的注释不但无益反而有害。尽量避免在注释中使用缩写，特别是不常用缩写。注释的位置应与被描述的代码相邻，可以放在代码的上方或右方，不可放在下方。 5.3 变量
18、、常量的注释对于所有有物理含义的变量、常量，在定义和声明时都必须加以注释，说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方。 数据结构定义和声明(包括数组、结构、类、枚举等)，必须加以注释。对数据结构的注释应放在其上方相邻位置，不可放在下面；对结构中的每个成员的注释放在此成员的右方；同一结构中不同成员的注释要对齐。 全局变量要有较详细的注释，包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。,五、注释,如： #define GUI_TXT_DISP_MOD 0x0C /文本框内文字显示模式 #define GUI_TXT_RIGHT_DISP 0x00 /文
19、本框内文字左对齐显示 #define GUI_TXT_LEFT_DISP 0x04 /文本框内文字左对齐显示 #define GUI_TXT_CENTRE_DISP 0x08 /文本框内文字居中显示 typedef struct CTR_ASPECT Aspect; /外观 INT8U *pTxt; /文字INT8U TxtFont; /字体INT8U Sta; /文本框状态模式INT8U WorkMod; /工作模式 TXT_BOX;,五、注释,5.4 函数的注释 /* 可编辑文本框选项左移 * * 功能描述 : 按向左键时，可编辑文本框的编辑位向左移一位。 * 输入参数 : pbox 指向
20、可编辑文本框的指针 * 返回参数 : 无 * 作 者 : Liy-tj */ void GUI_EditTxtBox_Left(EDIT_TXT_BOX *pbox) ,5.5 /* */ 和 /文件头、函数头注释使用“/* */”，函数内部注释“/” ，如：/* * GET HOW LONG KEY HAS BEEN PRESSED * * Description : Function return the time the key has been pressed. * * Arguments : none * * Returns : key down time in milliseconds * * Author : Liy-tj * */ INT32U KEY_GetKeyDownTime (void) INT32U ctr;OS_ENTER_CRITICAL(); / Start of critical section of codectr = KeyDownCtr; / Get key down countOS_EXIT_CRITICAL(); / End of critical section of codereturn (ctr * KEY_SCAN_DLY); ,五、注释,THE END,
