欧美极品高清xxxxhd,国产日产欧美最新,无码AV国产东京热AV无码,国产精品人与动性XXX,国产传媒亚洲综合一区二区,四库影院永久国产精品,毛片免费免费高清视频,福利所导航夜趣136

標(biāo)題: C語(yǔ)言命名規(guī)范 [打印本頁(yè)]

作者: zzlzx 時(shí)間: 2020-12-22 10:10
標(biāo)題: C語(yǔ)言命名規(guī)范
C是一門樸素的語(yǔ)言，你使用的命名也應(yīng)該這樣。與Modula-2和Pascal程序員不同，C程序員不使用諸如“ThisVariableIsATemporaryCounter”這樣“聰明”的名字。C程序員應(yīng)該叫它“tmp”，這寫(xiě)起來(lái)更簡(jiǎn)單，也不會(huì)更難懂。
然而，當(dāng)面對(duì)復(fù)雜情況時(shí)就有些棘手，給全局變量取一個(gè)描述性的名字是必要的。把一個(gè)全局函數(shù)叫做“foo”是一種目光短淺的行為。全局函數(shù)也一樣，如果你有一個(gè)統(tǒng)計(jì)當(dāng)前用戶個(gè)數(shù)的函數(shù)，應(yīng)當(dāng)把它命名為“count_active_user()”或者簡(jiǎn)單點(diǎn)些的類似名稱，不應(yīng)該命名為“cntusr()”。
3.1 三種流行的命名法則

目前，業(yè)界共有四種命名法則：駝峰命名法、匈牙利命名法、帕斯卡命名法和下劃線命名法，其中前三種是較為流行的命名法。

(1)駝峰命令法。正如它的名稱所表示的那樣，是指混合使用大小寫(xiě)字母來(lái)構(gòu)成變量和函數(shù)的名字。例如，下面是分別用駱駝式命名法和下劃線法命名的同一個(gè)函數(shù)：
printEmployeePaychecks()；
print_employee_paychecks()；

第一個(gè)函數(shù)名使用了駝峰命名法，函數(shù)名中的每一個(gè)邏輯斷點(diǎn)都有一個(gè)大寫(xiě)字母來(lái)標(biāo)記。第二個(gè)函數(shù)名使用了下劃線法，函數(shù)名中的每一個(gè)邏輯斷點(diǎn)都有一個(gè)下劃線來(lái)標(biāo)記。

駝峰命名法近年來(lái)越來(lái)越流行了，在許多新的函數(shù)庫(kù)和Microsoft Windows這樣的環(huán)境中，它使用得當(dāng)相多。另一方面，下劃線法是C出現(xiàn)后開(kāi)始流行起來(lái)的，在許多舊的程序和UNIX這樣的環(huán)境中，它的使用非常普遍。

(2)匈牙利命名法。廣泛應(yīng)用于象Microsoft Windows這樣的環(huán)境中。Windows 編程中用到的變量(還包括宏)的命名規(guī)則為匈牙利命名法，這種命名技術(shù)是由一位能干的 Microsoft 程序員查爾斯-西蒙尼(Charles Simonyi) 提出的。

匈牙利命名法通過(guò)在變量名前面加上相應(yīng)的小寫(xiě)字母的符號(hào)標(biāo)識(shí)作為前綴，標(biāo)識(shí)出變量的作用域、類型等。這些符號(hào)可以多個(gè)同時(shí)使用，順序是先m_(成員變量)、再指針、再簡(jiǎn)單數(shù)據(jù)類型、再其它。這樣做的好處在于能增加程序的可讀性，便于對(duì)程序的理解和維護(hù)。

例如：m_lpszStr, 表示指向一個(gè)以0字符結(jié)尾的字符串的長(zhǎng)指針成員變量。
匈牙利命名法關(guān)鍵是：標(biāo)識(shí)符的名字以一個(gè)或者多個(gè)小寫(xiě)字母開(kāi)頭作為前綴；前綴之后的是首字母大寫(xiě)的一個(gè)單詞或多個(gè)單詞組合，該單詞要指明變量的用途。

(3)帕斯卡(pascal)命名法。與駝峰命名法類似，二者的區(qū)別在于：駝峰命名法是首字母小寫(xiě)，而帕斯卡命名法是首字母大寫(xiě)，如：
DisplayInfo();
string UserName;
二者都是采用了帕斯卡命名法。

(4)三種命名規(guī)則的小結(jié)：MyData就是一個(gè)帕斯卡命名的示例；myData是一個(gè)駝峰命名法,它第一個(gè)單詞的第一個(gè)字母小寫(xiě),后面的單詞首字母大寫(xiě),看起來(lái)像一個(gè)駱駝；iMyData是一個(gè)匈牙利命名法,它的小寫(xiě)的i說(shuō)明了它的型態(tài)，后面的和帕斯卡命名相同，指示了該變量的用途。
3.2 命名的基本原則

(1)標(biāo)識(shí)符的命名要清晰、明了，有明確含義，同時(shí)使用完整的單詞或大家基本可以理解的縮寫(xiě)，避免使人產(chǎn)生誤解——盡量采用采用英文單詞或全部中文全拼表示，若出現(xiàn)英文單詞和中文混合定義時(shí)，使用連字符“_”將英文與中文割開(kāi)。較短的單詞可通過(guò)去掉“元音”形成縮寫(xiě)；較長(zhǎng)的單詞可取單詞的頭幾個(gè)字母形成縮寫(xiě)；一些單詞有大家公認(rèn)的縮寫(xiě)。例如：temp->tmp、flag->flg、statistic->stat、increment->inc、message->msg等縮寫(xiě)能夠被大家基本認(rèn)可。

(2)命名中若使用特殊約定或縮寫(xiě)，則要有注釋說(shuō)明。應(yīng)該在源文件的開(kāi)始之處，對(duì)文件中所使用的縮寫(xiě)或約定，特別是特殊的縮寫(xiě)，進(jìn)行必要的注釋說(shuō)明。

(3)自己特有的命名風(fēng)格，要自始至終保持一致，不可來(lái)回變化。個(gè)人的命名風(fēng)格，在符合所在項(xiàng)目組或產(chǎn)品組的命名規(guī)則的前提下，才可使用。(即命名規(guī)則中沒(méi)有規(guī)定到的地方才可有個(gè)人命名風(fēng)格)。

(4)對(duì)于變量命名，禁止取單個(gè)字符(如i 、j 、k... )，建議除了要有具體含義外，還能表明其變量類型、數(shù)據(jù)類型等，但i 、j 、k 作局部循環(huán)變量是允許的。變量，尤其是局部變量，如果用單個(gè)字符表示，很容易敲錯(cuò)(如i寫(xiě)成j)，而編譯時(shí)又檢查不出來(lái)，有可能為了這個(gè)小小的錯(cuò)誤而花費(fèi)大量的查錯(cuò)時(shí)間。

(5)除非必要，不要用數(shù)字或較奇怪的字符來(lái)定義標(biāo)識(shí)符。

(6)命名規(guī)范必須與所使用的系統(tǒng)風(fēng)格保持一致，并在同一項(xiàng)目中統(tǒng)一。

(7)在同一軟件產(chǎn)品內(nèi)，應(yīng)規(guī)劃好接口部分標(biāo)識(shí)符(變量、結(jié)構(gòu)、函數(shù)及常量)的命名，防止編譯、鏈接時(shí)產(chǎn)生沖突。對(duì)接口部分的標(biāo)識(shí)符應(yīng)該有更嚴(yán)格限制，防止沖突。如可規(guī)定接口部分的變量與常量之前加上“模塊”標(biāo)識(shí)等。

(8)用正確的反義詞組命名具有互斥意義的變量或相反動(dòng)作的函數(shù)等。
下面是一些在軟件中常用的反義詞組。
add / remove    begin / end       create / destroy
insert / delete    first / last       g et / release
increment / decrement                put / get
add / delete       lock / unlock    open / close
min / max       old / new       start / stop
next / previous    source / target    show / hide
send / receive    source / destination
cut / paste       up / down

示例：
int  min_sum;
int  max_sum;
int  add_user( BYTE *user_name );
int  delete_user( BYTE *user_name );

(9)除了編譯開(kāi)關(guān)/ 頭文件等特殊應(yīng)用，應(yīng)避免使用_EXAMPLE_TEST_ 之類以下劃線開(kāi)始和結(jié)尾的定義。
3.3 變量名的命名規(guī)則

(1)變量的命名規(guī)則要求用“匈牙利法則”。
即開(kāi)頭字母用變量的類型，其余部分用變量的英文意思、英文的縮寫(xiě)、中文全拼或中文全拼的縮寫(xiě),要求單詞的第一個(gè)字母應(yīng)大寫(xiě)。
即：變量名=變量類型+變量的英文意思(或英文縮寫(xiě)、中文全拼、中文全拼縮寫(xiě))
對(duì)非通用的變量，在定義時(shí)加入注釋說(shuō)明，變量定義盡量可能放在函數(shù)的開(kāi)始處。
見(jiàn)下表：
bool 用b開(kāi)頭 bFlg
int 用i開(kāi)頭 iCount
short int 用n開(kāi)頭 nStepCount
long int 用l開(kāi)頭 lSum
char  用c開(kāi)頭 cCount
unsigned char 用by開(kāi)頭
float 用f開(kāi)頭 fAvg
double 用d開(kāi)頭 dDeta
unsigned int(WORD) 用w開(kāi)頭 wCount
unsigned long int(DWORD) 用dw開(kāi)頭 dwBroad
字符串用s開(kāi)頭 sFileName
用0結(jié)尾的字符串用sz開(kāi)頭 szFileName

(2)指針變量命名的基本原則為：
對(duì)一重指針變量的基本原則為：“p”+變量類型前綴+命名，如一個(gè)float*型應(yīng)該表示為pfStat。對(duì)二重指針變量的基本規(guī)則為：“pp”+變量類型前綴+命名。對(duì)三重指針變量的基本規(guī)則為：“ppp”+變量類型前綴+命名。

(3)全局變量用g_開(kāi)頭,如一個(gè)全局的長(zhǎng)型變量定義為g_lFailCount。即：變量名=g_+變量類型+變量的英文意思(或縮寫(xiě))。此規(guī)則還可避免局部變量和全局變量同名而引起的問(wèn)題。

(4)靜態(tài)變量用s_開(kāi)頭,如一個(gè)靜態(tài)的指針變量定義為s_plPerv_Inst。即：變量名=s_+變量類型+變量的英文意思(或縮寫(xiě))

(5)對(duì)枚舉類型(enum)中的變量，要求用枚舉變量或其縮寫(xiě)做前綴。并且要求用大寫(xiě)。如：
enum cmEMDAYS
{
EMDAYS_MONDAY;
EMDAYS_TUESDAY;
……
};

(6)對(duì)struct、union變量的命名要求定義的類型用大寫(xiě)。并要加上前綴，其內(nèi)部變量的命名規(guī)則與變量命名規(guī)則一致。

結(jié)構(gòu)一般用S開(kāi)頭，如：
struct ScmNPoint
{
int nX;//點(diǎn)的X位置
int nY; //點(diǎn)的Y位置
};

聯(lián)合體一般用U開(kāi)頭，如:
union UcmLPoint
{
LONG lX;
LONG lY;
}

(7)對(duì)常量(包括錯(cuò)誤的編碼)命名，要求常量名用大寫(xiě)，常量名用英文表達(dá)其意思。當(dāng)需要由多個(gè)單詞表示時(shí)，單詞與單詞之間必須采用連字符“_”連接。
如：#define CM_FILE_NOT_FOUND CMMAKEHR(0X20B) 其中CM表示類別。

(8)對(duì)const 的變量要求在變量的命名規(guī)則前加入c_。即：c_+變量命名規(guī)則；示例：const char* c_szFileName;
3.4 函數(shù)的命名規(guī)范

(1)函數(shù)的命名應(yīng)該盡量用英文(或英文縮寫(xiě)、中文全拼、中文全拼縮寫(xiě))表達(dá)出函數(shù)完成的功能——函數(shù)名應(yīng)準(zhǔn)確描述函數(shù)的功能。遵循動(dòng)賓結(jié)構(gòu)的命名法則，函數(shù)名中動(dòng)詞在前,并在命名前加入函數(shù)的前綴，函數(shù)名的長(zhǎng)度不得少于8個(gè)字母。函數(shù)名首字大寫(xiě)，若包含有兩個(gè)單詞的每個(gè)單詞首字母大寫(xiě)。如果是OOP 方法，可以只有動(dòng)詞(名詞是對(duì)象本身)。示例：
LONG GetDeviceCount(……);
void print_record( unsigned int rec_ind ) ;
int  input_record( void ) ;
unsigned char get_current_color( void ) ;

(2)避免使用無(wú)意義或含義不清的動(dòng)詞為函數(shù)命名。如使用process、handle等為函數(shù)命名，因?yàn)檫@些動(dòng)詞并沒(méi)有說(shuō)明要具體做什么。

(3)必須使用函數(shù)原型聲明。函數(shù)原型聲明包括：引用外來(lái)函數(shù)及內(nèi)部函數(shù)，外部引用必須在右側(cè)注明函數(shù)來(lái)源：模塊名及文件名；內(nèi)部函數(shù)，只要注釋其定義文件名——和調(diào)用者在同一文件中(簡(jiǎn)單程序)時(shí)不需要注釋。
應(yīng)確保每個(gè)函數(shù)聲明中的參數(shù)的名稱、類型和定義中的名稱、類型一致。
3.5 函數(shù)參數(shù)命名規(guī)范

(1)參數(shù)名稱的命名參照變量命名規(guī)范。
(2)為了提高程序的運(yùn)行效率，減少參數(shù)占用的堆棧，傳遞大結(jié)構(gòu)的參數(shù)，一律采用指針或引用方式傳遞。
(3)為了便于其他程序員識(shí)別某個(gè)指針參數(shù)是入口參數(shù)還是出口參數(shù)，同時(shí)便于編譯器檢查錯(cuò)誤，應(yīng)該在入口參數(shù)前加入const標(biāo)志。
如：……cmCopyString(const CHAR * c_szSource, CHAR * szDest)
3.6 文件名(包括動(dòng)態(tài)庫(kù)、組件、控件、工程文件等)的命名規(guī)范

文件名的命名要求表達(dá)出文件的內(nèi)容，要求文件名的長(zhǎng)度不得少于5個(gè)字母，嚴(yán)禁使用象file1,myfile之類的文件名。

歡迎光臨 (http://www.raoushi.com/bbs/)