当前位置:首页 > 公众号精选 > strongerHuang
[导读]关注、 星标公众号,不错过精彩内容 素材来源:micrium 编辑整理:strongerHuang 开发过项目的工程师都知道,一个好的项目,代码基本都有统一的规范,否则代码就会随着版本迭代,变得越来越臃肿。 代码规范应在项目早期建立,这些规范对于保持整个项目的一致

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

素材来源: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代码中使用的缩写比较多,比如:
缩写
原意
Addr Address
Blk Block
Chk Check
Clr Clear
Cnt Count
CPU Central Processing Unit
Ctr Counter
Ctx Context
Cur Current
Del Delete
Dly Delay
Err Error

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

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

µ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”查看更多内容,回复“加群”按规则加入技术交流群。


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

免责声明:本文内容由21ic获得授权后发布,版权归原作者所有,本平台仅提供信息存储服务。文章仅代表作者个人观点,不代表本平台立场,如有问题,请联系我们,谢谢!

本站声明: 本文章由作者或相关机构授权发布,目的在于传递更多信息,并不代表本站赞同其观点,本站亦不保证或承诺内容真实性等。需要转载请联系该专栏作者,如若文章内容侵犯您的权益,请及时联系本站删除。
换一批
延伸阅读

9月2日消息,不造车的华为或将催生出更大的独角兽公司,随着阿维塔和赛力斯的入局,华为引望愈发显得引人瞩目。

关键字: 阿维塔 塞力斯 华为

加利福尼亚州圣克拉拉县2024年8月30日 /美通社/ -- 数字化转型技术解决方案公司Trianz今天宣布,该公司与Amazon Web Services (AWS)签订了...

关键字: AWS AN BSP 数字化

伦敦2024年8月29日 /美通社/ -- 英国汽车技术公司SODA.Auto推出其旗舰产品SODA V,这是全球首款涵盖汽车工程师从创意到认证的所有需求的工具,可用于创建软件定义汽车。 SODA V工具的开发耗时1.5...

关键字: 汽车 人工智能 智能驱动 BSP

北京2024年8月28日 /美通社/ -- 越来越多用户希望企业业务能7×24不间断运行,同时企业却面临越来越多业务中断的风险,如企业系统复杂性的增加,频繁的功能更新和发布等。如何确保业务连续性,提升韧性,成...

关键字: 亚马逊 解密 控制平面 BSP

8月30日消息,据媒体报道,腾讯和网易近期正在缩减他们对日本游戏市场的投资。

关键字: 腾讯 编码器 CPU

8月28日消息,今天上午,2024中国国际大数据产业博览会开幕式在贵阳举行,华为董事、质量流程IT总裁陶景文发表了演讲。

关键字: 华为 12nm EDA 半导体

8月28日消息,在2024中国国际大数据产业博览会上,华为常务董事、华为云CEO张平安发表演讲称,数字世界的话语权最终是由生态的繁荣决定的。

关键字: 华为 12nm 手机 卫星通信

要点: 有效应对环境变化,经营业绩稳中有升 落实提质增效举措,毛利润率延续升势 战略布局成效显著,战新业务引领增长 以科技创新为引领,提升企业核心竞争力 坚持高质量发展策略,塑强核心竞争优势...

关键字: 通信 BSP 电信运营商 数字经济

北京2024年8月27日 /美通社/ -- 8月21日,由中央广播电视总台与中国电影电视技术学会联合牵头组建的NVI技术创新联盟在BIRTV2024超高清全产业链发展研讨会上宣布正式成立。 活动现场 NVI技术创新联...

关键字: VI 传输协议 音频 BSP

北京2024年8月27日 /美通社/ -- 在8月23日举办的2024年长三角生态绿色一体化发展示范区联合招商会上,软通动力信息技术(集团)股份有限公司(以下简称"软通动力")与长三角投资(上海)有限...

关键字: BSP 信息技术
关闭
关闭