嵌入式软件设计之：标识符与命名规则

命名风格：

1. unix like 风格：单词用小写字母，单词之间用'_'连接。如：driver_led_init();get_main_pwr();

2. windows 风格：单词连在一起，每个单词首字母大写。如：GetMainPwr();DriverLedInit();

3. 匈牙利命令法: 不提倡

原则1  标识符命名要清晰、明了，含义明确，使用约定的缩写或完整单词，避免产生歧义。

int error_number;

int number_of_completed_connection;

不好的命名：

int n;int nerr; int n_comp_conns;

2.常用的缩写：

argument:arg

buffer:buff

clock:clk

command:cmd

compare:cmp

configuration:cfg

device:dev

error:err

hexadecimal:hex

increment:inc

initialize:init

maximum:max

minimum:min

message:msg

parameter:para

previous:prev

register:reg

semaphore:sem

statistic:stat

synchronize:sync

temp:tmp

3.用正确的反义词组命名具有互斥意义的变量或相反动作的函数

add--remove  begin---end  create--delete  

first--last         take----release  increment--decrement

get--put          lock---unlock    open--close

min--max         old--new         start--stop

next--previous   show--hide    send--receive

source--target    source--destination  copy--paste   up--down

4.重构、修改代码风格应保持一致

文件命名规则

文件命名统一采用小写字符

像windows系统不区分大小写字母，linux系统区分大小写字母，所以统一使用小写字母命名文件。

变量命名规则

全局变量前应增加"g_"前辍

静态变量前应增加"s_"前戳

函数命名规则

以函数要执行的动作命名，一般用动词或动词+名词的方式

如：get_current_time();

宏命名规则

数值或字符串等常量的定义，采用全大写字母+‘_’的方式

#define  CONNECTION_MAX_NUM 32

枚举量

同上

除了头文件和编译开关等特殊标识定义，宏定义不能使用下划线‘_’做开头和结尾，以为这些通常是C99内部定义，避免冲突。