代码为什么需要遵循规范,来看看µC/OS代码规范

关注、星标公众,不错过精彩内容

素材来源:micrium

编辑整理:strongerHuang

开发过项目的工程师都知道,一个好的项目,代码基本都有统一的规范,否则代码就会随着版本迭代,变得越来越臃肿。

代码规范应在项目早期建立,这些规范对于保持整个项目的一致性非常有必要,采用一致的规范可以提高效率并简化项目维护。

采用一致的规范可以:

  • 可移植性

  • 一致性

  • 整洁

  • 维修方便

  • 容易理解

  • 简单


下面来看看著名的µC/OS代码的规范。

一、标头

C源文件的标头如下所示,公司名称和地址可以在前几行,后跟一个标题,用于描述文件的内容。其中包含版权声明,以警告该软件的专有性等。

/*
************************************************************************************************
*                                          Company Name
*                                             Address
*
*                         (c) Copyright 19xx, Company Name, City, State
*                                       All Rights Reserved
*
*
* Filename     :
* Programmer(s):
* Description  :
************************************************************************************************
*/
/*$PAGE*/

二、包含文件

#include包含通常有两种方式,在源文件中包含所需的头文件,还有一种把所有头文件都整理在一个文件,比如INCLUDES.H。这样你就不必记住哪个头文件与哪个源文件一起使用,尤其是在添加新模块时。唯一的不便是编译每个文件需要更长的时间。

/*
************************************************************************************************
*                                        INCLUDE FILES
************************************************************************************************
*/
#include "INCLUDES.H"
/*$PAGE*/

三、命名标识符

符合ANSI C标准的C编译器(到目前为止,大多数C编译器都这样做)最多允许32个字符作为标识符名称。标识符是变量、结构/联合成员、函数、宏、#defines等。

比如:大写字符用于分隔标识符中的单词,功能和下划线字符(_)类似。

static  INT16U KeyCharCnt;                  /* Number of keys pressed            */
static  char   KeyInBuf[100];               /* Storage buffer to hold chars      */
        char   KeyInChar;                   /* Character typed                   */


/*$PAGE*/

µC/OS命名标识符:

  • 函数声明中的形式参数应仅包含小写字符。

  • 自动变量名称应仅包含小写字符。

  • 静态变量和函数应使用文件/模块名称(或其一部分)作为前缀,并应使用大写/小写字符。

  • extern变量和函数应使用文件/模块名称(或其一部分)作为前缀,并应使用大写/小写字符。

四、缩略

代码基本都会使用缩写,缩写不能中英文混合,通常是英文的缩写,比如OS代表Operating System。

一些常用的缩写需要统一规范,一些不常用的缩写需要在代码中注释清除。

µC/OS代码中使用的缩写比较多,比如:

缩写
原意
AddrAddress
BlkBlock
ChkCheck
ClrClear
CntCount
CPUCentral Processing Unit
CtrCounter
CtxContext
CurCurrent
DelDelete
DlyDelay
ErrError

五、注释

//  /* */ 是两种最常见注释的方法,还有注释的位置也很关键。通常在代码所在行上一行,或者在代码所在行(代码后面)。

但也有奇葩把代码注释在代码所在行的下一行(通常不建议这么操作)。

µC/OS使用 /**/ 而且都在代码所在行(后面):

int atoi (char *s)
{
    int n;                                  /* Partial result of conversion                   */




    n = 0;                                  /* Initialize result                              */
    while (*s >= '0' && *s <= '9' && *s) {  /* For all valid characters and not end of string */
        n = 10 * n + *s - '0';              /* Convert char to int and add to partial result  */
        s++;                                /* Position on next character to convert          */
    }
    return (n);                             /* Return the result of the converted string      */
}

六、#defines

头文件(.H)和C源文件(.C)可能需要定义常量和宏,常量和宏始终使用大写字母。

#define  KEY_FF           0x0F
#define  KEY_CR           0x0D
#define  KEY_BUF_FULL()  (KeyNRd > 0)

七、数据类型

C语言允许你使用typedef关键字创建新的数据类型,µC/OS使用大写字符声明所有数据类型,因此遵循用于常量和宏的相同规则,永远不会混淆常量,宏和数据类型的问题。

typedef  unsigned char  BOOLEAN;            /* Boolean               */
typedef  unsigned char  INT8U;              /*  8 bit unsigned       */
typedef  char           INT8S;              /*  8 bit signed         */
typedef  unsigned int   INT16U;             /* 16 bit unsigned       */
typedef  int            INT16S;             /* 16 bit signed         */
typedef  unsigned long  INT32U;             /* 32 bit unsigned       */
typedef  long           INT32S;             /* 32 bit signed         */
typedef  float          FP;                 /* Floating Point        */

八、局部变量

一些源模块要求使用局部变量,通过使用static关键字,变量可以按字母顺序或功能顺序列出。

static  char    KeyBuf[100];
static  INT16S  KeyNRd;

九、缩进

缩进有使用空格和Tab两种符号,规范通常只使用一种,不能空格和Tab两种混合使用(现在很多编辑器都支持Tab替换成空格的功能)。

如果混合使用,在不同编辑器打开代码,你就可能会看到一团糟。

µC/OS使用四个空格:

if (x < 0)
    z = 25;
if (y > 2) {
    z = 10;
    x = 100;
    p++;
}

十、结构体和联合体

包含结构体和联合体的格式、命名、注释等这些都需要规范,µC/OS代码使用的比较简单,也是大众化的定义:

typedef struct line {           /* Structure that defines a LINE                 */
     int  LineStartX;           /* 'X' & 'Y' starting coordinate                 */
     int  LineStartY;    
     int  LineEndX;             /* 'X' & 'Y' ending   coordinate                 */
     int  LineEndY;      
     int  LineColor;            /* Color of line to draw                         */
} LINE;
typedef struct point {          /* Structure that defines a POINT                */
    int  PointPosX;             /* 'X' & 'Y' coordinate of point                 */
    int  PointPosY;
    int  PointColor;            /* Color of point                                */
} POINT;

本文就写到这里,代码规范建议参考一些大厂的规范手册。当然,每家公司的代码规范可能有所不同,只要写代码是时统一就行。

免责声明:本文素材来源网络,版权归原作者所有。如涉及作品版权问题,请与我联系删除。

推荐阅读:

在多任务(RTOS)环境中使用看门狗的重要性

Windows Terminal 1.0 和 Linux 版有啥区别

从大端CPU迁移到小端CPU,及字节序的迁移技术

关注微信公众号『strongerHuang』,后台回复“1024”查看更多内容,回复“加群”按规则加入技术交流群。

长按前往图中包含的公众号关注

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章