常見命名規則
駱駝(Camel)命名法近年來越來越流行,
在許多新的函數庫和Java這樣的平臺下使用得當相多。
駱駝命名法,正如它的名稱所表示的那樣,指的是混合使用大小寫字母來構成標識符的名字。
其中第一個單詞首字母小寫,餘下的單詞首字母大寫。
例如:printEmployeePaychecks(),函數名中每一個邏輯斷點都有一個大寫字母來標記。
帕斯卡(Pascal)命名法與駱駝命名法類似。
只不過駱駝命名法是第一個單詞首字母小寫,而帕斯卡命名法則是第一個單詞首字母大寫。
例如:DisplayInfo()和UserName都是採用了帕斯卡命名法。
在C#中,以帕斯卡命名法和駱駝命名法居多。
事實上,很多程序設計者在實際命名時會將駱駝命名法和帕斯卡結合使用,
例如變量名採用駱駝命名法,而函數採用帕斯卡命名法。
另一種流行的命名規則稱爲下劃線命名法。
2 函數的命名
函數名使用下劃線分割小寫字母的方式命名:
如:
tic_init()
adc_is_busy()
uart_tx_char()
中斷函數的命名直接使用 設備名_isr() 的形式命名,如:
timer2_isr()
3 變量的命名
變量的命名也採用下劃線分割小寫字母的方式命名。
命名應當準確,不引起歧義,且長度適中。如:
int length;
uint32 test_offset;
單字符的名字也是常用的,如i, j, k等,它們通常可用作函數內的局部變量。
tmp常用做臨時變量名。
局部靜態變量,應加s_詞冠(表示static),如:
static int s_lastw;
全局變量(尤其是供外部訪問的全局變量),應加g_詞冠(表示global),如:
void (* g_capture_hook)(void);
4 常量及宏的命名
採用下劃線分割大寫字母的方式命名,一般應以設備名作爲前綴,
防止模塊間命名的重複。如:
#define TIMER0_MODE_RELOAD 2
#define TIMER2_COUNT_RETRIEVE(val) ((uint16)(65536 - (val)))
當然,看作接口的宏可以按照函數的命名方法命名,例如:
#define timer2_clear() (TF2 = 0)
#define timer0_is_expired() (TF0)