資源描述:
《C語言程序開發(fā)規(guī)范》由會(huì)員上傳分享,免費(fèi)在線閱讀,更多相關(guān)內(nèi)容在工程資料-天天文庫。
1、C語言程序開發(fā)規(guī)范封頁11?引言1.1.目的使用本規(guī)范是為了支持下述軟件胡質(zhì):無錯(cuò)誤、有失效保障、可靠一個(gè)軟件產(chǎn)品,如果嚴(yán)格符合它的規(guī)范就是止確的,如果在異常環(huán)境下仍然能夠工作就是健壯的(robust)o無錯(cuò)誤、有失效保障、可靠就是指一個(gè)軟件產(chǎn)品既正確又健壯??删S護(hù)一個(gè)軟件產(chǎn)品,如果它可以隨著規(guī)范的改變而方便地進(jìn)行修正就是可擴(kuò)展的;如果一個(gè)熟悉該軟件規(guī)程的新程序員能夠輕松地理解它的實(shí)現(xiàn)就是可讀的;如果能夠整個(gè)或部分地被一個(gè)新的應(yīng)用所重用就是可重用的。可維護(hù)就是指一個(gè)軟件產(chǎn)品可擴(kuò)展、可讀并幾可重用??梢浦惨?/p>
2、個(gè)軟件產(chǎn)品,如果可以方便地轉(zhuǎn)移到一個(gè)不同的硬件或軟件環(huán)境中應(yīng)用,那么它是可移植的。可配置_?個(gè)軟件產(chǎn)品,如果能夠輕松地選擇源代碼的正確版本和其它聯(lián)編一個(gè)軟件產(chǎn)品所需的部件,那么它是可配置的。可驗(yàn)證—?個(gè)軟件產(chǎn)品,如來能夠在驗(yàn)證階段輕松地準(zhǔn)備測(cè)試數(shù)據(jù)和檢測(cè)故障的程序,那么它就是可驗(yàn)證的。易調(diào)試一個(gè)軟件產(chǎn)品,如果能夠輕松地從故障上溯查找到錯(cuò)誤所在,那么它是容易調(diào)試的。1.2.致性凡所有開發(fā)的C軟件都必須遵循本文檔的要求,第三方軟件可以冇例外。其中,規(guī)則必須遵守,而建議則希望被遵守,如不能遵守,其原因必須作書面
3、記載。所冇對(duì)規(guī)則或建議的違背都必須有書面記載。1.3.術(shù)語標(biāo)識(shí)符(ident辻ier):指C中的一個(gè)變量、常量、函數(shù)或類型。在本文檔中它與“名稱”同義。定義(define):變量或常量的定義是指編譯器為其分配的內(nèi)存。函數(shù)的定義是指函數(shù)體的實(shí)現(xiàn)(也是為代碼分配內(nèi)存)。聲明(declare):指一些實(shí)體對(duì)編譯器的聲明所在的位置,如函數(shù)原型、類型(由typedef定義)、變量利常量。聲明不分配內(nèi)存。宏(macro):指由#define語句定義的代替一個(gè)文本串的名字。當(dāng)該名字在源程序小出現(xiàn)時(shí),預(yù)處理器用對(duì)應(yīng)文木串
4、代替它C固有數(shù)據(jù)類型(或預(yù)定義或基本數(shù)據(jù)類型):由語言本身定義的數(shù)據(jù)類型,如in—用戶定義數(shù)據(jù)類型:編程人員用struct、union、enum或typedef定義的數(shù)據(jù)類型。范圍:標(biāo)識(shí)符的范圍是指其可見的環(huán)境。環(huán)境在這里指口J以使川該標(biāo)識(shí)符的函數(shù)或程序塊。全局:使用范圍沒有限制。文件級(jí)局部:使用范I韋I局限在一個(gè)文件中。函數(shù)級(jí)局部:使用范圍局限在一個(gè)函數(shù)屮。2.文件目錄【建議2-1-1]每個(gè)模塊的代碼(包括頭文件)放在以“系統(tǒng)+模塊”方式命名的冃錄下?!窘ㄗh2-1-2]文件的命名使用“系統(tǒng)+模塊(+功能
5、)”的方式命名。例:RNC系統(tǒng)RANAP模塊的C語言代碼應(yīng)該為RNC_RANAP.C和RNC_RANAP.H,如果程序太大仍需分為不同的文件,則按功能區(qū)分,比如:RNC_RANAP_DTSPATCH.C。【規(guī)則2-1-2]實(shí)現(xiàn)同一功能的不同函數(shù)應(yīng)在同一文件內(nèi)。【規(guī)則2-1-3]在每個(gè)子目錄內(nèi)要編寫README文件對(duì)文件及子目錄的組織結(jié)構(gòu)作細(xì)致的描述。README文件模板見附錄H3.文件結(jié)構(gòu)C++/C程序的頭文件以“.h”為后綴,C程序的定義文件以“.C”為后綴。3.1?版權(quán)和版本的聲明版權(quán)和版本的聲明位于
6、頭文件和定義文件的開頭(參見示例3-1),主要內(nèi)容有:(1)版權(quán)信息。(2)文件名,作者/修改者,完成tl期。(3)最終版本號(hào)(必須跟最新修改記錄的版本號(hào)相同),實(shí)現(xiàn)目的。(4)修改記錄。/^y.^y.^y.^y.^y.^y.^y./*[■"[、"[、"[、"[、"▲、"[J“[*"1、?▲J"A、"[、"I、*[■"[、"I、*[、"I、?]*?[■^4^"]、"[、■}?"[、"[、"]■"[、,▲、■」■"▲、"[、"右、"]■"[、"[、*]、^7%xi%"[■^*7^"]、?[、xl%"[■■[
7、、"[、?[、"[■*[*"[、?7%"[、
8、%"(?"]、/*XXXXXXXXXXXXXX有限公司版權(quán)所有S%f^>X^%F^kL^%F^^JxkL^%F^kL^>A^%fx>A^xfxxlxxfxkL^%1^>A^kl^>A^%V^^Jx%1^%1^%1^^Jx%!>%J^kIxvl^//*@
9、Beijing,China*//*Unpublishedwork-rightsreservedundertheChinaCopyrightAct.*//*/*/*/*馳ENDINTERNALLEGAL??Use,duplication,ordisclosurebythegovernmentissubjectto*/restrictionssetforthintheCDTTcommerciallicenseagreement.*