C語言命名規(guī)范10條.docVIP

C語言命名規(guī)范10條從事C語言的教學(xué)也有兩年了，在教學(xué)中發(fā)現(xiàn)學(xué)生們在編程方面有一個(gè)極不好的習(xí)慣，就是隨意命名，這不僅給自己日后閱讀自己程序時(shí)帶來不便，也給其他的程序閱讀者帶來麻煩，更重要的是沒有統(tǒng)一的規(guī)范總顯得像是個(gè)游擊隊(duì)，沒有正規(guī)軍的感覺，企業(yè)也不愿意要業(yè)余選手，所以C語言的初學(xué)者最好一開始就培養(yǎng)一種良好的編程習(xí)慣，也許日后進(jìn)入公司有些改動(dòng)，需要適應(yīng)，但基本的規(guī)范和規(guī)則是不需要改的，這樣可以幫助你少走很多彎路，經(jīng)過這些年的學(xué)習(xí)和工作，總結(jié)了一些規(guī)范的內(nèi)容，為了好記，便于傳播，特總結(jié)為十條，建議讀者采納。1) 標(biāo)識(shí)符的命名要清晰、明了，有明確含義，同時(shí)使用完整的單詞或大家基本可以理解的縮寫，避免使人產(chǎn)生誤解。程序中的英文單詞一般不會(huì)太復(fù)雜，用詞應(yīng)當(dāng)準(zhǔn)確。例如不要把CurrentValue寫成NowValue。2) 不允許使用漢語拼音命名，更不要使用漢語，必須使用英文來命名標(biāo)識(shí)符。盡量避免名字中出現(xiàn)數(shù)字編號，如Value1,Value2等，除非邏輯上的確需要編號。3) 函數(shù)名、變量名從第二個(gè)單詞起首字母大寫。如：printName(), oldName等4) 在C 程序中只使用const常量而不使用宏常量，即const常量完全取代宏常量。常量定義以大寫字母K開頭，字母全部使用大寫，如：const int KSIZE = 100。5) 代碼縮進(jìn)使用4個(gè)空格，不推薦使用TAB鍵6) 版權(quán)和版本的聲明位于文件的開頭；函數(shù)頭部應(yīng)進(jìn)行注釋，列出：函數(shù)的功能、輸入?yún)?shù)、輸出參數(shù)、返回值等。關(guān)鍵代碼注釋位于被注釋代碼上方，且用空行與其他代碼分割開，如：文件頭注釋：author: SDL teamfunction: testing hardware drivers and IDEdate: 2009.10copy right: Software College Of HeBei Normal University 函數(shù)注釋：function:SDL initialparameter: nonereturn: booltrue: initial SDL normallyfalse: initial SDL abnormally 關(guān)鍵代碼注釋：pTemp = SDL_LoadBMP(aFileName);/format BMP file*aImg = SDL_DisplayFormat(pTemp); SDL_FreeSurface(pTemp);7) 靜態(tài)變量加前綴s_，如：static int s_count = 0;8) 盡量避免應(yīng)用全局變量，如果有特殊情況必須定義的話，全局變量以小寫g_開頭，如：int g_count = 0;9) 結(jié)構(gòu)體的名字開頭字母要大寫。如：struct Stud