c语言优秀编程风格

实用标准文案作为一个初学者如何具有良好的程序设计风格呢？我想引用一个关于初学者请教编程大师的故事让读者自己去领悟。有一位编程大师，他写非结构化的程序， 一位初学者刻意模仿他， 也写非结构化的程序。当他让大师看他的进步时，大师批评了他的非结构化程序：“ 对一位编程大师合适的东西未必对一个初学者同样合适，在超越结构化之前，你必须理解编程之道。” 我个人认为作为一个初学者应该踏踏实实的打好程序设计的基础， 不要急功近利，舍本逐末。我走过不少弯路，希望大家能和我一样能牢记编程大师的忠告： “对编程大师合适的东西未必对一个初学者同样合适”。本文所描述的优秀编程风格适合于大部分语言， 文章中可能提到你不是很了解的概念， 没有关系，你放心的读下去，当你使用 AVR一个月之后，你什么都明白了。AVRc语言优秀编程风格文件结构模块化的程序应该是有一个很好的程序结构的。 AVRC语言程序有两种用户文件， .c程序文件，.h头文件，程序中编写过程中需要在 .c文件中包含.h头文件。初学者往往出现重复包含或者头文件包含错误的问题， 我当时也时常为这种错误而发愁。 下面我以我写的电机驱动例程来给大家说明一下，优秀的编程文件结构。精彩文档实用标准文案这个工程中有 8个文件，一个说明文件，如下图：下载程序例子 电机控制案例 。文件结构我写的成型的程序的文件个数基本上都是偶数， 因为每一个结构化的函数定义 .c文件都会对应一个.h文件。main.c 对应 config.h 。我们来看看各文件的包含关系。下面我们看看这些文件的包含关系与内容： [推荐的文件包含顺序与关系 ]*所有.c文件都包含了 config.h 文件。如： #include"config.h"在config.h中有如下代码：#include"delay.h"#include"device_init.h"#include"motor.h"这样做就不容易出现错误的包含关系，为了预防万一，我们还引入了宏定义与预编译。如下：#ifndef_UNIT_H__#define_UNIT_H__1//100usexternvoidDelay100us(uint8n);精彩文档实用标准文案//1sexternvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.//1msexternvoidDelay1ms(uint16n);#endif第一次包含本文件的时候正确编译，并且 #define _UNIT_H__ 1，第二次包含本文件#ifndef_UNIT_H__ 就不再成立，跳过文件。预编译还有更多的用途，比如可以根据不同的值编译不同的语句，如下：//#pragmaREGPARMS#ifCPU_TYPE==M128#include<iom128v.h>#endif#ifCPU_TYPE==M64#include<iom64v.h>#endif#ifCPU_TYPE==M32#include<iom32v.h>#endif#ifCPU_TYPE==M16#include<iom16v.h>精彩文档实用标准文案#endif#ifCPU_TYPE==M8#include<iom8v.h>#endif* #include<filename> 与 #include "filename" 的区别 ：前者是包含系统目录include 下的文件，后者是包含程序目录下的文件。变量名与函数名变量以及函数命名应该按照尽量短， 按需长，具有实际意义。可以通过下划线或者大小写结合的方法组合动词和名词组成变量函数名。下面对比好的命名方法与不好的命名方法：1.好的：Delay100us();不好的：Yanshi();2.好的：init_devices();不好的：Chengxuchushihua();3.好的：inttemp;不好的：intdd;外部调用精彩文档实用标准文案首先在模块化程序的.h文件中定义extern端口初始化externvoidport_init(void);//T2 初始化voidtimer2_init(void);各种参数初始化externvoidinit_devices(void);模块化程序的.c文件中定义函数，不要在模块化的程序中调用程序，及不要出现向timer2_init(); 这样函数的使用， 因为你以后不知道你到底什么地方调用了函数， 导致程序调试难度增加。可以在定义函数的过程中调用其他函数作为函数体。/************************** 采用timer2 产生波形***********************/PWM频率=系统时钟频率/（分频系数*2*计数器上限值））voidtimer2_init(void){TCCR2=0x00;//stopTCNT2=0x01;//setcountOCR2=0x66;//setcompare精彩文档实用标准文案TCCR2=(1<<WGM20)|(1<<WGM21)|(1<<COM21)|0x06;//starttimer 快速pwm 模式，匹配清零，溢出置位 256分频// 占 空 比 ＝ 高 比 低 为 ：(OCR2-0X01)/(0XFF-OCR2) OX01++++++(OCR2)__________OXFF(+ 表示输出高，_表示输出低)即OCR2越大，输出越大}3.在少数几个文件中调用函数，在 main.c 中调用大部分函数，在 interupts.c 中根据不同的中断调用服务函数。voidmain(void){/******************************************************************************/初始工作/******************************************************************************/init_devices();while(1){for_ward(0); //默认速度运转 正精彩文档实用标准文案Delay1s(5);//延时5smotor_stop();//停止Delay1s(5);//延时5sback_ward(0);//默认速度运转反Delay1s(5);//延时5sspeed_add(20);//加速Delay1s(5);//延时5sspeed_subtract(20);//减速Delay1s(5);//延时5s}}宏定义宏定义主要用于两个地方：一是用得非常多的命令或语句，利用宏将其简化。#ifndefTRUE#defineTRUE1#endif精彩文档实用标准文案#ifndefFALSE#defineFALSE0#endif#ifndefNULL#defineNULL0#endif#defineMIN(a,b) ((a<b)?(a):(b))#defineMAX(a,b) ((a>b)?(a):(b))#defineABS(x) ((x>)?(x):(-x))typedef unsigned charuint8; /* 定义可移植的无符号8位整数关键字 */typedefsigned charint8; /* 定义可移植的有符号 8位整数关键字 */typedefunsignedintuint16;/*定义可移植的无符号16位整数关键字*/typedefsignedintint16;/*定义可移植的有符号16位整数关键字*/typedefunsignedlonguint32;/*定义可移植的无符号32位整数关键字*/typedefsignedlongint32;/*定义可移植的有符号32位整数关键字*/精彩文档实用标准文案二是利用宏定义方便的进行硬件接口操作，再程序需要修改时，只需要修改宏定义即可，而不需要满篇去找命令行，进行修改。//PD4,PD5 电机方向控制 如果更改管脚控制电机方向，更改 PORTD|=0x10 即可。#definemoto_en1PORTD|=0x10#definemoto_en2PORTD|=0x20#definemoto_uen1PORTD&=~0x10#definemoto_uen2PORTD&=~0x20//启动TC2定时比较和溢出#defineTC2_ENTIMSK|=(<<1OCIE2)|(1<<TOIE2)禁止TC2再定时比较和溢出#defineTC2_DISTIMSK&=~(1<<OCIE2)|(1<<TOIE2)关于注释为了增加程序的可读性， 方便合作者读动程序，或者程序作者在一段时间之后还能看懂程序，我们需要在程序中写 注释。在比较特殊的函数使用或者命令调用的地方加单行注释。使用方法为：Tbuf_putchar(c,RTbuf); // 将数据加入到发送缓冲区并开中断externvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.精彩文档实用标准文案在模块化的函数中使用详细段落注释：/***********************函数名称:Com_putchar功能描述:从串行口输出一个字符c输入:c:输出字符输出:0:失败1:成功全局变量:无调用模块:说明：注意：********************/在文件头上加文件名，文件用途，作者，日期等信息。/*********************************************************************************************************** serial driver** (c)Copyright2005-2006,limaokui** AllRightsReserved**精彩文档实用标准文案**V1.1.0******-------------- 文 件 信 息--------------------------------------------------------------------------------文件名:sio.c创建人:李茂奎最后修改日期:2005年7月13日**描 述:serial driver****-------------- 历 史 版 本 信 息----------------------------------------------------------------------------创建人:李茂奎版本:V1.00日期:2005年