C語(yǔ)言格式書(shū)寫(xiě)規(guī)范

1/1C語(yǔ)言格式書(shū)寫(xiě)規(guī)范C語(yǔ)言書(shū)寫(xiě)規(guī)范指南第1章文件結(jié)構(gòu)每個(gè)C程序通常分為兩個(gè)文件。

一個(gè)文件用于保存程序的聲明（declaration），稱(chēng)為頭文件。

另一個(gè)文件用于保存程序的實(shí)現(xiàn)（implementation），稱(chēng)為定義（definition）文件。

C程序的頭文件以.h為后綴，C程序的定義文件以.c為后綴。

1.1版權(quán)和版本的聲明版權(quán)和版本的聲明位于頭文件和定義文件的開(kāi)頭（參見(jiàn)示例1-1），主要內(nèi)容有：

（1）版權(quán)信息。

（2）文件名稱(chēng)，標(biāo)識(shí)符，摘要。

（3）當(dāng)前版本號(hào)，作者/修改者，完成日期。

（4）版本歷史信息。

/**Copyright(c)2001,吉林大學(xué)物理學(xué)院無(wú)線(xiàn)電*Allrightsreserved.**文件名稱(chēng)：

filename.h*文件標(biāo)識(shí)：

*摘要：

簡(jiǎn)要描述本文件的內(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）頭文件開(kāi)頭處的版權(quán)和版本聲明（參見(jiàn)示例1-1）。

（2）預(yù)處理塊。

（3）函數(shù)和類(lèi)結(jié)構(gòu)聲明等。

假設(shè)頭文件名稱(chēng)為SCL_SPI.h，頭文件的結(jié)構(gòu)參見(jiàn)示例1-2。

【規(guī)則1-2-1】為了防止頭文件被重復(fù)引用，應(yīng)當(dāng)用#ifndef/#define/#endif結(jié)構(gòu)產(chǎn)生預(yù)處理塊。

【規(guī)則1-2-2】用#includelt;filename.hgt;格式來(lái)引用標(biāo)準(zhǔn)庫(kù)的頭文件（編譯器將從標(biāo)準(zhǔn)庫(kù)目錄開(kāi)始搜索）。

【規(guī)則1-2-3】用#includefilename.h格式來(lái)引用非標(biāo)準(zhǔn)庫(kù)的頭文件（編譯器將從用戶(hù)的工作目錄開(kāi)始搜索）。

【規(guī)則1-2-4】#include后面使用TAB鍵控制排版。

【規(guī)則1-2-5】頭文件中只存放聲明而不存放定義【規(guī)則1-2-6】全局變量在頭文件中聲明,在.c文件中定義.hexternintvalue;聲明。

.cintvalue=0x10;定義。

【規(guī)則1-2-7】局部變量在.c中定義(static)unsignedintvalue;定義。

//版權(quán)和版本聲明見(jiàn)示例1-1，此處省略。

#ifndef#define#includeSCL_SPI_H//防止SCL_SPI.h被重復(fù)引用SCL_SPI_Hlt;p30f6014A.hgt;//引用標(biāo)準(zhǔn)庫(kù)的頭文件#includeSCL_CAN.h//引用非標(biāo)準(zhǔn)庫(kù)的頭文件voidFunction1();//全局函數(shù)聲明externunsignintvalue;//全局變量聲明#endif示例1-2C頭文件的結(jié)構(gòu)1.3定義文件的結(jié)構(gòu)定義文件有三部分內(nèi)容：

（1）定義文件開(kāi)頭處的版權(quán)和版本聲明（參見(jiàn)示例1-1）。