这种嵌入式软件代码命名，都无需看注解了

良好的编程习惯，决定了今后代码的质量。

很多工程师不注重平时编码习惯，比如命名规则，一会大写、一会小写，一会中文拼音，一会下划线等，导致自己写的代码自己都看不懂了。

今天就来分享一点关于软件代码常见的几种命名规则。

例如：m_lpszStr, 表示指向一个以0字符结尾的字符串的长指针成员变量。

例如：bEnable, nLength, hWnd。

下面分享关于匈牙利命名法中常用的小写字母的前缀。

属性部分：

• g_ 全局变量

• c_ 　常量

• m_ 　c++类成员变量

• s_ 　静态变量

类型部分：

• 数组 a

• 指针　p

• 函数　fn

• 无效　v

• 句柄　h

• 长整型　l

• 布尔　b

• 浮点型（有时也指文件）　f

• 双字 　dw

• 字符串　 sz

• 短整型　 n

• 双精度浮点　d

• 计数　c（通常用cnt）

• 字符　ch（通常用c）

• 整型　i（通常用n）

• 字节　by

• 字　w

• 实型　r

• 无符号　u

描述部分：

• 最大　Max

• 最小　Min

• 初始化　Init

• 临时变量　T（或Temp）

• 源对象　Src

• 目的对象　Dest

例如：

printEmployeePaychecks();

函数名中每一个逻辑断点都有一个大写字母来标记。

例如：

DisplayInfo();

UserName

都是采用了帕斯卡命名法。

事实上，很多程序设计者在实际命名时会将驼峰命名法和帕斯卡结合使用，例如变量名采用驼峰命名法，而函数采用帕斯卡命名法。

下划线法是随着C语言的出现流行起来的，在UNIX/LIUNX这样的环境，以及GNU代码中使用非常普遍。

1.函数的命名

函数名使用下划线分割小写字母的方式命名：

设备名_操作名();

操作名一般采用：谓语（此时设备名作为宾语或者标明操作所属的模块）或者谓语 宾语/表语（此时设备名作为主语或者标明操作所属的模块） 等形式，如：

tic_init();

adc_is_busy();

uart_tx_char();

中断函数的命名直接使用 设备名_isr() 的形式命名，如：

timer2_isr();

2.变量的命名

变量的命名也采用下划线分割小写字母的方式命名。命名应当准确，不引起歧义，且长度适中。如：

int length;

uint32 test_offset;

单字符的名字也是常用的，如i, j, k等，它们通常可用作函数内的局部变量。tmp常用做临时变量名。

局部静态变量，应加s_词冠（表示static），如：

static int s_lastw;

全局变量（尤其是供外部访问的全局变量），应加g_词冠（表示global），如：

void (* g_capture_hook)(void);

3.常量及宏的命名

采用下划线分割大写字母的方式命名，一般应以设备名作为前缀，

防止模块间命名的重复。如：

#define TIMER0_MODE_RELOAD 2

#define TIMER2_COUNT_RETRIEVE(val) ((uint16)(65536 - (val)))

当然，看作接口的宏可以按照函数的命名方法命名，例如：

#define timer2_clear() (TF2 = 0)

#define timer0_is_expired() (TF0)

据考察，没有一种命名规则可以让所有的程序员赞同，程序设计教科书一般都不指定命名规则。

命名规则对软件产品而言并不是“成败悠关”的事，我们不要化太多精力试图发明世界上最好的命名规则，而应当制定一种令大多数项目成员满意的命名规则，并在项目中贯彻实施。

‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧  END  ‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧