1 常見命名規(guī)則

比較著名的命名規(guī)則首推匈牙利命名法，

這種命名方法是由Microsoft程序員查爾斯·西蒙尼(Charles Simonyi) 提出的。

其主要思想是“在變量和函數(shù)名中加入前綴以增進人們對程序的理解”。

匈牙利命名法關(guān)鍵是：標識符的名字以一個或者多個小寫字母開頭作為前綴;

前綴之后的是首字母大寫的一個單詞或多個單詞組合，該單詞要指明變量的用途。

例如：lpszStr, 表示指向一個以'\0'結(jié)尾的字符串(sz)的長指針(lp)變量。

駱駝(Camel)命名法近年來越來越流行，

在許多新的函數(shù)庫和Java這樣的平臺下使用得當相多。

駱駝命名法，正如它的名稱所表示的那樣，指的是混合使用大小寫字母來構(gòu)成標識符的名字。

其中第一個單詞首字母小寫，余下的單詞首字母大寫。

例如：printEmployeePaychecks()，函數(shù)名中每一個邏輯斷點都有一個大寫字母來標記。

帕斯卡(Pascal)命名法與駱駝命名法類似。

只不過駱駝命名法是第一個單詞首字母小寫，而帕斯卡命名法則是第一個單詞首字母大寫。

例如：DisplayInfo()和UserName都是采用了帕斯卡命名法。

在C#中，以帕斯卡命名法和駱駝命名法居多。

事實上，很多程序設(shè)計者在實際命名時會將駱駝命名法和帕斯卡結(jié)合使用，

例如變量名采用駱駝命名法，而函數(shù)采用帕斯卡命名法。

另一種流行的命名規(guī)則稱為下劃線命名法。

下劃線法是隨著C語言的出現(xiàn)流行起來的，在UNIX/LIUNX這樣的環(huán)境，以及GNU代碼中使用非常普遍。

本章所述的命名規(guī)則主要基于下劃線命名法發(fā)展而來。

2 函數(shù)的命名

函數(shù)名使用下劃線分割小寫字母的方式命名：

設(shè)備名_操作名()

操作名一般采用：謂語(此時設(shè)備名作為賓語或者標明操作所屬的模塊)或者

謂語+賓語/表語(此時設(shè)備名作為主語或者標明操作所屬的模塊) 等形式，如：

tic_init()

adc_is_busy()

uart_tx_char()

中斷函數(shù)的命名直接使用 設(shè)備名_isr() 的形式命名，如：

timer2_isr()

3 變量的命名

變量的命名也采用下劃線分割小寫字母的方式命名。

命名應(yīng)當準確，不引起歧義，且長度適中。如：

int length;

uint32 test_offset;

單字符的名字也是常用的，如i, j, k等，它們通常可用作函數(shù)內(nèi)的局部變量。

tmp常用做臨時變量名。

局部靜態(tài)變量，應(yīng)加s_詞冠(表示static)，如：

static int s_lastw;

全局變量(尤其是供外部訪問的全局變量)，應(yīng)加g_詞冠(表示global)，如：

void (* g_capture_hook)(void);

4 常量及宏的命名

采用下劃線分割大寫字母的方式命名，一般應(yīng)以設(shè)備名作為前綴，

防止模塊間命名的重復(fù)。如：

#define TIMER0_MODE_RELOAD 2

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

當然，看作接口的宏可以按照函數(shù)的命名方法命名，例如：

#define timer2_clear() (TF2 = 0)

#define timer0_is_expired() (TF0)

5 常用縮寫詞

原詞 縮寫

addition add 加

subtraction sub 減

multiplication mul 乘法

division div 除法

answer ans 響應(yīng)、回答

array arr 數(shù)組、集合

average avg 平均

buffer buf或buff 緩沖區(qū)

capture cap或capt 捕獲

check chk 檢查

count cnt 計數(shù)器

column col 列

control ctrl 控制

decode dec 解碼、譯碼

define def 定義

delete del 刪除

destination dst或dest 目的

display disp 顯示

encode enc 編碼

environment env 環(huán)境

error err 錯誤

float flt 浮動、浮點

frequency freq 頻率

header hdr 開始、開頭

index idx 索引、指示、

image img 影像、鏡像

increment inc 增加、增量

initalize init 初始化

iteration itr 循環(huán)、迭代

length len 長度

memory mem 內(nèi)存

middle mid 中值

make mk 制造、形成

message msg 消息

number num 數(shù)量、編號

operand opnd 操作數(shù)

optimization opt 最優(yōu)

operator optr 操作

packet pkt 消息包

positon pos 位置

previous pre或prev 以前的

pointer ptr 指針

record rcd 記錄

receive recv 收到、接收

result res 結(jié)果

return ret 返回

source src 源頭

stack stk 棧

string str 字符串

table tab 表

temporary tmp或temp 臨時

total tot 全部的

time stamp ts 時間戳

value val 值