单片机 C语言 编程风格

文件头说明 ：源程序（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。

 

/************************************************************

  版权信息：

  文件名: test.cpp

  作者:                  日期:
 

  功能:     
 

  版本:        
 

  历史修改记录
 

  <作者>  <日期>   <版本 >   <说明>
 

***********************************************************/
 

 

常量、编译宏命名

说明：常量、编译宏全部大写，单词间使用下划线分隔。

对于变量命名，禁止取单个字符（如i、j、k...），建议除了要有具体含义外，还能表明其变量类型、数据类型等，但i、j、k作局部循环变量是允许的。说明：变量，尤其是局部变量，如果用单个字符表示，很容易敲错（如i写成j），而编译时又检查不出来，有可能为了这个小小的错误而花费大量的查错时间。

 

示例：下面所示的局部变量名的定义方法可以借鉴。

int  liv_Width

其变量名解释如下：

       l     局部变量（Local）  （其它：g    全局变量（Global）...）

       i     数据类型（Interger）
 

    boolean b
    char c
    long     l
    float     f
    double   d
   int i
   unsigned int ui
   指针 p
   结构 s
   输入管脚 bi
   输出管脚 bo 

 

 

       v     变量（Variable）   （其它：c    常量（Const）...）

       Width 变量含义