【正文】 C語言書寫規(guī)范指南第1章文件結構每個C程序通常分為兩個文件。一個文件用于保存程序的聲明（declaration），稱為頭文件。另一個文件用于保存程序的實現(xiàn)（implementation），稱為定義（definition）文件。C程序的頭文件以“.h”為后綴，C程序的定義文件以“.c”為后綴。版權和版本的聲明位于頭文件和定義文件的開頭（參見示例11），主要內容有：（1）版權信息。（2）文件名稱，標識符，摘要。（3）當前版本號，作者/修改者，完成日期。（4）版本歷史信息。/**Copyright(c)2001,吉林大學物理學院無線電*Allrightsreserved.**文件名稱：*文件標識： *摘 要：簡要描述本文件的內容**當前版本：*作 者：輸入作者（或修改者）名字*完成日期：2007年7月20日**取代版本：*原作者 ：輸入原作者（或修改者）名字*完成日期：2007年5月10日*/示例11版權和版本的聲明頭文件由三部分內容組成：（1）頭文件開頭處的版權和版本聲明（參見示例11）。（2）預處理塊。（3）函數(shù)和類結構聲明等。假設頭文件名稱為 ，頭文件的結構參見示例12?！疽?guī)則121】為了防止頭文件被重復引用，應當用 ifndef/define/endif結構產(chǎn)生預處理塊。【規(guī)則122】用 include 格式來引用標準庫的頭文件（編譯器將從標準庫目錄開始搜索）?！疽?guī)則123】用 include “”格式來引用非標準庫的頭文件（編譯器將從用戶的工作目錄開始搜索）?！疽?guī)則124】 include 后面使用TAB鍵控制排版 ?！疽?guī)則125】頭文件中只存放“聲明”而不存放“定義”【規(guī)則126】全局變量在頭文件中聲明, .h extern in tvalue。 聲明。.c in tvalue=0x10。 定義。【規(guī)則127】 (static) unsigned in tvalue。 定義。//版權和版本聲明見示例11，此處省略。 ifndef SCL_SPI_H //define SCL_SPI_Hinclude //引用標準庫的頭文件…include “” //引用非標準庫的頭文件…void Function1(…)。//全局函數(shù)聲明…extern unsign int value。//全局變量聲明endif示例12C頭文件的結構定義文件有三部分內容：（1）定義文件開頭處的版權和版本聲明（參見示例11）。（2）對一些頭文件的引用。（3）程序的實現(xiàn)體（包括數(shù)據(jù)和代碼）。，定義文件的結構參見示例13。//版權和版本聲明見示例11，此處省略。include“” //引用頭文件…//全局變量定義unsign int value = 0x10。//全局函數(shù)的實現(xiàn)體void Function1(…){…} 示例13C定義文件的結構早期的編程語言如Basic、Fortran沒有頭文件的概念，C語言的初學者雖然會用使用頭文件，但常常不明其理。這里對頭文件的作用略作解釋：（1）通過頭文件來調用庫功能。在很多場合，源代碼不便（或不準）向用戶公布，只要向用戶提供頭文件和二進制的庫即可。用戶只需要按照頭文件中的接口聲明來調用庫功能，而不必關心接口怎么實現(xiàn)的。編譯器會從庫中提取相應的代碼。（2）頭文件能加強類型安全檢查。如果某個接口被實現(xiàn)或被使用時，其方式與頭文件中的聲明不一致，編譯器就會指出錯誤，這一簡單的規(guī)則能大大減輕程序員調試、改錯的負擔。 如果一個軟件的頭文件數(shù)目比較多（如超過十個），通常應將頭文件和定義文件分別保存于不同的目錄，以便于維護。例如可將頭文件保存于 include 目錄，將定義文件保存于 source 目錄（可以是多級目錄）。如果某些頭文件是私有的，它不會被用戶的程序直接引用，則沒有必要公開其“聲明”。為了加強信息隱藏，這些私有的頭文件可以和定義文件存放于同一個目錄。 第2章程序的版式版式雖然不會影響程序的功能，但會影響可讀性。程序的版式追求清晰、美觀，是程序風格的重要構成因素?？梢园殉绦虻陌媸奖扔鳛椤皶ā薄：玫摹皶ā笨勺屓藢Τ绦蛞荒苛巳?，看得興致勃勃。差的程序“書法”如螃蟹爬行，讓人看得索然無味，更令維護者煩惱有加。請程序員們學習程序的“書法”，彌補大學計算機教育的漏洞，實在很有必要。空行起著分隔程序段落的作用?？招械皿w（不過多也不過少）將使程序的布局更加清晰?？招胁粫速M內存，雖然打印含有空行的程序是會多消耗一些紙張，但是值得。所以不要舍不得用空行。【規(guī)則211】在每個函數(shù)定義結束之后都要加空行。參見示例21（a）【規(guī)則212】在一個函數(shù)體內，邏揖上密切相關的語句之間不加空行，其它地方應加空行分隔。參見示例21（b）//空行void Function1(…){…}//空行void Function2(…){…}示例21(a)函數(shù)之間的空行//空行while (condition){statement1。//空行if (condition){statement2。}else{statement3。}//空行statement4。}示例21(b)函數(shù)內部的空行 【規(guī)則221】一行代碼只做一件事情，如只定義一個變量，或只寫一條語句。這樣的代碼容易閱讀，并且方便于寫注釋。【規(guī)則222】if、for、while、do等語句自占一行，執(zhí)行語句不得緊跟其后。不論執(zhí)行語句有多少都要加{}。這樣可以防止書寫失誤。 示例22（a）為風格良好的代碼行，示例22（b）為風格不良的代碼行。int width。//寬度int height。//高度int depth。//深度中間使用TAB鍵控制距離int width,height,depth。//寬度高度深度x = a+b。 //等號左右用空格控制距離y = c+d。z = e+f。x = a+b。 y=c+d。z=e+f。if (width height)//左右用空格控制距離{ dosomething()。//使用TAB鍵控制距離}if(widthheight)dosomething()。for (initialization。 condition。 update){dosomething()。//使用TAB鍵控制距離}//空行other()。for(initialization。condition。update)dosomething()。other()。示例22(a)風格良好的代碼行 示例22(b)風格不良的代碼行【建議221】盡可能在定義變量的同時初始化該變量（就近原則）如果變量的引用處和其定義處相隔比較遠，變量的初始化很容易被忘記。如果引用了未被初始化的變量，可能會導致程序錯誤。本建議可以減少隱患。例如int width = 10。 //定義并初紿化widthint height = 10。 //定義并初紿化heightint depth = 10。 //定義并初紿化depth使用TAB鍵控制距離z 【規(guī)則231】關鍵字之后要留空格。象const、virtual、inline、case等關鍵字之后至少要留一個空格，否則無法辨析關鍵字。象if、for、while等關鍵字之后應留一個空格再跟左括號‘（’，以突出關鍵字。z 【規(guī)則232】函數(shù)名之后不要留空格，緊跟左括號‘（’，以與關鍵字區(qū)別。z 【規(guī)則233】‘（’向后緊跟，‘）’、‘，’、‘?！蚯熬o跟，緊跟處不留空格。z 【規(guī)則234】‘，’之后要留空格，如Function(x,y,z)。如果‘?！皇且恍械慕Y束符號，其后要留空格，如for (initialization。 condition。 update)。z 【規(guī)則235】賦值操作符、比較操作符、算術操作符、邏輯操作符、位域操作符，如“=”、“+=”“=”、“=”、“+”、“*”、“%”、“amp。amp?！?、“||”、“”,“^”等二元操作符的前后應當加空格。z 【規(guī)則236】一元操作符如“!”、“~”、“++”、“”、“amp?！保ǖ刂愤\算符）等前后不加空格。z 【規(guī)則237】象“［］”、“.”、“”這類操作符前后不加空格。? 【建議231】對于表達式比較長的for語句和if語句，為了緊湊起見可以適當?shù)厝サ粢恍┛崭?，如for(i=0。i10。i++)和if((a=b)amp。amp。(c=d))void Func1(int x,int y,int z)。 //良好的風格void Func1 (int x,int y,int z)。 //不良的風格if (year = 2000) //良好的風格if(year=2000) //不良的風格if ((a=b) amp。amp。 (c=d)) //良好的風格if(a=bamp。amp。c=d) //不良的風格for (i=0。 i10。 i++) //良好的風格for(i=0。i10。i++) //不良的風格for(I = 0。 I 10。 I++) //過多的空格x = a b ? a : b。 //良好的風格x=ab?a:b。 //不好的風格int *x = amp。y。 //良好的風格int*x=amp。y。 //不良的風格arr