【正文】 / 不良的風格☆ // 不良的風格float GetValue(void)。 【】 參數(shù)的書寫要完整，不要貪圖省事只寫參數(shù)的類型而省略參數(shù)名字，如果函數(shù)沒有參數(shù)，則用void填充；例如：void SetValue(int nWidth, int nHeight)。 參數(shù)的規(guī)則☆C++ 語言中多了引用傳遞（pass by reference）。 函數(shù)接口的兩個要素是參數(shù)和返回值。函數(shù)設(shè)計的細微缺點很容易導致該函數(shù)被錯用，所以光使函數(shù)的功能正確是不夠的。if (…){ … while (…) {…} // end of while…} // end of if 程序的注釋 文件頭的注釋 ，文件頭的注釋是以兩行斜杠開始，以兩行斜杠結(jié)束(以區(qū)別于函數(shù)的注釋)。 【】 如果代碼本來就是清楚的，則不必加注釋；例如 i++。 【】 注釋是對代碼的“提示”，而不是文檔，程序中的注釋不可喧賓奪主，注釋太多了會讓人眼花繚亂，注釋的花樣要少；☆☆雖然注釋有助于理解代碼，但注意不可過多地使用注釋。C++語言中，程序塊的注釋常采用“/*…*/”，行注釋一般采用“//…”。雖然將x和y分行定義可以避免誤解，但并不是人人都愿意這樣做。 從語義上講此寫法比較直觀，即x是int 類型的指針，上述寫法的弊端是容易引起誤解，例如：int* x, y。 very_longer_update){ DoSomething()。for (very_longer_initialization。}virtual CMatrix CMultiplyMatrix (CMatrix leftMatrix, CMatrix rightMatrix)。amp。amp。 update){… // program code}While (condition){… // program code}while (condition){… // program code}如果出現(xiàn)嵌套的｛｝，則使用縮進對齊，如： { … { … } …} update){… // program code}for (initialization。if (condition){… // program code}else{… // program code}if (condition){… // program code}else {… // program code}for (initialization。void Function(int x){… // program code} 代碼行內(nèi)的空格 // Do not use b Function()。 // Do not use a . Function()。 // Do not use array [ 5 ] = 0。 y。y。 // favorable stylex=ab?a:b。 I 10。i10。 i10。amp。amp。 // favorable stylevoid Func1 (int x,int y,int z)。 (c=d)) i++)和if ((a=b) amp。 【】 對于表達式比較長的for語句和if語句，為了緊湊起見可以適當?shù)厝サ粢恍┛崭?，如for (i=0。 【】 象“［］”、“.”、“”這類操作符前后不加空格；☆”（地址運算符）等前后不加空格；☆amp。 condition。 【】 ‘，’之后要留空格，如Function(x, y, z)，如果‘。’向前緊跟，緊跟處不留空格；☆Other()。 condition。 update){DoSomething()。for (initialization。if (nWidth nHight) { DoSomething()。 z = e + f。X ＝ a + b。y = c + d。//width,height,depth // depth // widthint nHeight。(a)為風格良好的代碼行，(b)為風格不良的代碼行。 【】 盡可能在定義變量的同時初始化該變量(就近原則)，如果變量的引用處和其定義處相隔比較遠，變量的初始化很容易被忘記。 【】 所有函數(shù)內(nèi)的變量都在函數(shù)開始處定義；☆ 【】 if、for、while、do等語句的“{”要單獨占用一行；☆ 【】 if、for、while、do等語句自占一行，執(zhí)行語句不得緊跟其后，不論執(zhí)行語句有多少都要加{}，這樣可以防止書寫失誤；☆ 【】 一行代碼只做一件事情，如只定義一個變量，或只寫一條語句,這樣的代碼容易閱讀，并且方便于寫注釋；☆ 代碼行☆ }// blank line statement4。 // blank line if (condition) { statement2。// blank linevoid Function1(…){ …}// blank linevoid Function2(…){ …}// blank linevoid Function3(…){ …} 【】 在一個函數(shù)體內(nèi)，邏揖上密切相關(guān)的語句之間不加空行，其它地方應加空行分隔。(a)；☆空行不會浪費內(nèi)存，雖然打印含有空行的程序是會多消耗一些紙張，但是值得。 空行空行起著分隔程序段落的作用。例如三維圖形標準OpenGL的所有庫函數(shù)均以gl開頭，所有常量（或宏定義）均以GL開頭。 EMDAYS_TUESDAY。} class CNode { //類成員變量或成員函數(shù) }。union URecordLen{ BYTE m_byRecordNum。 int m_nY。 標示符的長度應當以最小的長度實現(xiàn)最多信息，一般來說，長名字能更好地表達含義，但并非長的變量名就一定要比短的變量名要好，此外單字符的名字也是有用的，常見的如i,j,k,m,n,x,y,z等，它們通?？捎米骱瘮?shù)內(nèi)的局部變量； 【】 盡量避免名字中出現(xiàn)數(shù)字編號，如Value1,Value2等，除非邏輯上的確需要編號；注： 【】 用正確的反義詞組命名具有互斥意義的變量或相反動作的函數(shù)等；☆ 【】 全局函數(shù)的名字應當使用“動詞”或者“動詞＋名詞”(動賓詞組)；☆ 【】 變量的名字應當使用“名詞”或者“形容詞＋名詞”；☆ 【】 程序中不要出現(xiàn)標識符完全相同的局部變量和全局變量，盡管兩者的作用域不同而不會發(fā)生語法錯誤，但會使人誤解；☆☆amp。 總的說來，沒有一種命名規(guī)則可以讓所有的程序員贊同，且命名規(guī)則對軟件產(chǎn)品而言并不是“成敗悠關(guān)”的事，而且在不同的平臺和不同的環(huán)境下編寫的程序所應遵循的規(guī)則也不盡相同，所以我們只是追求制定一種令大多數(shù)項目成員滿意的命名規(guī)則，并在項目中貫徹實施。 // 前綴 i表示int類型 float fX, fY, fZ。 float x, y, z。如果一個變量由ppch開頭，則表明它是指向字符指針的指針。 命名規(guī)則 比較著名的命名規(guī)則當推“匈牙利” 命名法，該命名規(guī)則的主要思想是“在變量和函數(shù)名中加入前綴以增進人們對程序的理解”。如果某些頭文件是私有的，它不會被用戶的程序直接引用，則沒有必要公開其“聲明”。 目錄結(jié)構(gòu) 如果一個軟件的頭文件數(shù)目比較多（如超過十個），通常應將頭文件和定義文件分別保存于不同的目錄，以便于維護。編譯器會從庫中提取相應的代碼； （2） 頭文件能加強類型安全檢查。在很多場合，源代碼不便（或不準）向用戶公布，只要向用戶提供頭文件和二進制的庫即可。//class member function realizationvoid CBox::Draw(…){…}示例33 C++/C定義文件的結(jié)構(gòu) 頭文件的作用 早期的編程語言如Basic、Fortran沒有頭文件的概念，C++/C語言的初學者雖然會用使用頭文件，但常常不明其理。假設(shè)定義文件的名稱為 ，定義文件的結(jié)構(gòu)參見示例33。 對一些頭文件的引用；(3) 定義文件的結(jié)構(gòu)定義文件有三部分內(nèi)容：(1) //global function declare…class CBox //class structure decalre{…}。建議將成員函數(shù)的定義與聲明分開，不論該函數(shù)體有多么小。 【】 在C++ 語法中，類的成員函數(shù)可以在聲明的同時被定義，并且自動成為內(nèi)聯(lián)函數(shù)。 【】 宏定義和函數(shù)聲明分離，在兩個頭文件中定義，如果沒有類成員函數(shù)，可以將類和結(jié)構(gòu)的定義與函數(shù)聲明分離，也就是說一個頭文件專用于宏定義，一個頭文件專用于類和結(jié)構(gòu)的定義，一個頭文件專用于函數(shù)聲明；☆ 【】 頭文件中應包含所有定義文件所定義的函數(shù)聲明，如果一個頭文件對應多個定義文件，則不同定義文件內(nèi)實現(xiàn)的函數(shù)要分開聲明，并作注釋以解釋所聲明的函數(shù)從屬于那一個定義文件；☆ 【】 頭文件中只存放“聲明”而不存放“定義”；☆ 【】 用 include “” 格式來引用非標準庫的頭文件(編譯器將從用戶的工作目錄開始搜索)；☆ 【】 用 include 格式來引用標準庫的頭文件(編譯器將從標準庫目錄開始搜索)；☆ 【】 為了防止頭文件被重復引用，應當用ifndef/define/endif結(jié)構(gòu)產(chǎn)生預處理塊；“ifndef”或者“define”后以TAB鍵代替SPACE鍵做空格；如果頭文件名稱是由多個單詞組成，則各單詞間以下劃線“_”連接，例如有頭文件名稱為“”，則定義如下：“ifndef _FILE_SYSTEM_H_”；☆☆ 函數(shù)和類結(jié)構(gòu)聲明等。 頭文件開頭處的文件信息聲明(參見示例31)；(2) 【】 在主要函數(shù)部分描述了文件所包含的主要函數(shù)的聲明信息，如果是頭文件，這一部分是可以省略的。 C++/C程序的頭文件以“.h”為后綴，C程序的定義文件以“.c”為后綴，C++程序的定義文件通常以“.cpp”為后綴（也有一些系統(tǒng)以“.cc”或“.cxx”為后綴）。一個文件用于保存程序的聲明（declaration），稱為頭文件。 此規(guī)范以C/C++程序設(shè)計討論。 制定本編程規(guī)范的目的是為了提高軟件開發(fā)效率及所開發(fā)軟件的可維護性，提高軟件的質(zhì)量。修改日期修改內(nèi)容是否備份備注