c語言格式書寫規(guī)范

《c語言格式書寫規(guī)范》由會員上傳分享，免費在線閱讀，更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫。

1、C語言書寫規(guī)范指南第1章文件結(jié)構(gòu)每個C程序通常分為兩個文件。一個文件用于保存程序的聲明（declaration），稱為頭文件。另一個文件用于保存程序的實現(xiàn)（implementation），稱為定義（definition）文件。C程序的頭文件以“.h”為后綴，C程序的定義文件以“.c”為后綴。1.1版權(quán)和版本的聲明版權(quán)和版本的聲明位于頭文件和定義文件的開頭（參見示例1-1），主要內(nèi)容有：（1）版權(quán)信息。（2）文件名稱，標(biāo)識符，摘要。（3）當(dāng)前版本號，作者/修改者，完成日期。（4）版本歷史信息。/**Copyright(c)

2、2001,吉林大學(xué)物理學(xué)院無線電*Allrightsreserved.**文件名稱：filename.h*文件標(biāo)識：*摘要：簡要描述本文件的內(nèi)容**當(dāng)前版本：1.1*作者：輸入作者（或修改者）名字*完成日期：2007年7月20日**取代版本：1.0*原作者：輸入原作者（或修改者）名字*完成日期：2007年5月10日*/示例1-1版權(quán)和版本的聲明1.2頭文件的結(jié)構(gòu)頭文件由三部分內(nèi)容組成：（1）頭文件開頭處的版權(quán)和版本聲明（參見示例1-1）。（2）預(yù)處理塊。（3）函數(shù)和類結(jié)構(gòu)聲明等。假設(shè)頭文件名稱為SCL_SPI.h，頭文件

3、的結(jié)構(gòu)參見示例1-2?！疽?guī)則1-2-1】為了防止頭文件被重復(fù)引用，應(yīng)當(dāng)用#ifndef/#define/#endif結(jié)構(gòu)產(chǎn)生預(yù)處理塊?！疽?guī)則1-2-2】用#include格式來引用標(biāo)準(zhǔn)庫的頭文件（編譯器將從標(biāo)準(zhǔn)庫目錄開始搜索）?！疽?guī)則1-2-3】用#include“filename.h”格式來引用非標(biāo)準(zhǔn)庫的頭文件（編譯器將從用戶的工作目錄開始搜索）?！疽?guī)則1-2-4】#include后面使用TAB鍵控制排版。【規(guī)則1-2-5】頭文件中只存放“聲明”而不存放“定義”【規(guī)則1-2-6】全局變量在頭文件

4、中聲明,在.c文件中定義.hexternintvalue;聲明。.cintvalue=0x10;定義?！疽?guī)則1-2-7】局部變量在.c中定義(static)unsignedintvalue;定義。//版權(quán)和版本聲明見示例1-1，此處省略。#ifndefSCL_SPI_H//防止SCL_SPI.h被重復(fù)引用#defineSCL_SPI_H#include//引用標(biāo)準(zhǔn)庫的頭文件…#include“SCL_CAN.h”//引用非標(biāo)準(zhǔn)庫的頭文件…voidFunction1(…);//全局函數(shù)聲明…ext

5、ernunsignintvalue;//全局變量聲明#endif示例1-2C頭文件的結(jié)構(gòu)1.3定義文件的結(jié)構(gòu)定義文件有三部分內(nèi)容：（1）定義文件開頭處的版權(quán)和版本聲明（參見示例1-1）。（2）對一些頭文件的引用。（3）程序的實現(xiàn)體（包括數(shù)據(jù)和代碼）。假設(shè)定義文件的名稱為SCL_SPI.c，定義文件的結(jié)構(gòu)參見示例1-3。//版權(quán)和版本聲明見示例1-1，此處省略。#include“SCL_SPI.h”//引用頭文件…//全局變量定義unsignintvalue=0x10;//全局函數(shù)的實現(xiàn)體voidFunction1(…){

6、…}示例1-3C定義文件的結(jié)構(gòu)1.4頭文件的作用早期的編程語言如Basic、Fortran沒有頭文件的概念，C語言的初學(xué)者雖然會用使用頭文件，但常常不明其理。這里對頭文件的作用略作解釋：（1）通過頭文件來調(diào)用庫功能。在很多場合，源代碼不便（或不準(zhǔn)）向用戶公布，只要向用戶提供頭文件和二進(jìn)制的庫即可。用戶只需要按照頭文件中的接口聲明來調(diào)用庫功能，而不必關(guān)心接口怎么實現(xiàn)的。編譯器會從庫中提取相應(yīng)的代碼。（2）頭文件能加強類型安全檢查。如果某個接口被實現(xiàn)或被使用時，其方式與頭文件中的聲明不一致，編譯器就會指出錯誤，這一簡單的規(guī)則

7、能大大減輕程序員調(diào)試、改錯的負(fù)擔(dān)。1.5目錄結(jié)構(gòu)如果一個軟件的頭文件數(shù)目比較多（如超過十個），通常應(yīng)將頭文件和定義文件分別保存于不同的目錄，以便于維護(hù)。例如可將頭文件保存于include目錄，將定義文件保存于source目錄（可以是多級目錄）。如果某些頭文件是私有的，它不會被用戶的程序直接引用，則沒有必要公開其“聲明”。為了加強信息隱藏，這些私有的頭文件可以和定義文件存放于同一個目錄。第2章程序的版式版式雖然不會影響程序的功能，但會影響可讀性。程序的版式追求清晰、美觀，是程序風(fēng)格的重要構(gòu)成因素?？梢园殉绦虻陌媸奖扔鳛椤皶?/p>

8、法”。好的“書法”可讓人對程序一目了然，看得興致勃勃。差的程序“書法”如螃蟹爬行，讓人看得索然無味，更令維護(hù)者煩惱有加。請程序員們學(xué)習(xí)程序的“書法”，彌補大學(xué)計算機教育的漏洞，實在很有必要。2.1空行空行起著分隔程序段落的作用?？招械皿w（不過多也不過少）將使程序的布局更加清晰?？招胁粫速M內(nèi)存，雖然打印含有空行的程序