每個函式的定義和說明應該從第1列開始書寫。函式名(包括參數列)和函式體的花括號(「」)應該各佔一行。在函式體結尾的括號(「}」)後面應該加上注釋,注釋中應該包括函式名,這樣比較方便進行括號配對檢查,也可以清晰地看出來函式是否結束。
範例1:函式的宣告
void matmyfunction(int n)
// matmyfunction
使用空格分割所有演算符號和運算元。
這條規則的例外是「->」,「「.」, 「()」和「」,這些操作符和運算元之間不空格。 當需要把乙個程式行的內容分成幾行寫時,操作符號應該放在行末,而不是下一行的開頭。
**書寫應該遵從結構化的要求,採用縮排的格式。最小縮排量為4個空格,整個檔案內部應該統一,不要混用tab鍵和4個空格這兩種情況,因為不同的編輯器對tab鍵的處理方法不同。
每行的長度不要超過80個字元,當程式行太長時,應該分行書寫。 分行時應該按照自然的邏輯關係進行。
例如:不要把乙個簡單的邏輯判斷寫在兩行上。 分行後的縮排應該按照程式的邏輯關係進行對齊。例如:參數列折行後,下面的行應該在參數列左括號的下方。
範例2:折行的格式
dwnewshape = mataffinetransform(coords, translation,
rotation);
if ( ( (new_shape.x > left_border) &&
(new_shape.x
< right_border) ) &&
( (new_shape.y > bottom_border) &&
(new_shape.y
< top_border) ) )
對於巢狀式的語句--即語句塊(如,if、while、switch等)應該包括在花括號中。花括號的左括號應該單獨佔一行,並與關鍵字對齊。建議即使語句塊中只有一條語句,也應該使用花括號包括,這樣可以使程式結構更清晰,也可以避免出錯。建議對比較長的塊,在末尾的花括號後加上注釋以表明該語言塊結束。
範例3:巢狀語句格式
if (value
< max >)
} else //if (value < max)
注釋必須做到清晰,準確地描述內容。對於程式中複雜的部分必須有注釋加以說明。注釋量要適中,過多或過少都易導致閱讀困難。
1.注釋風格
c語言中使用一組(/* … */)作為注釋界定符。 注釋內容盡量用英語方式表述。 注釋的基本樣式參考範例4。 注釋應該出現在要說明的內容之前,而不應該出現在其後。 除了說明變數的用途和語言塊末尾使用的注釋,盡量不使用行末的注釋方式。
範例4:幾種注釋樣式
/*
* *****
*****
*****
*****
*****
*****
*****
*****
*****
**** 強調注釋
* *****
*****
*****
*****
*****
*****
*****
*****
*****
****/
/** 塊注釋
*//* 單行注釋 */
int i; /*行末注釋*/
2.何時需要注釋
如果變數的名字不能完全說明其用途,應該使用注釋加以說明。 如果為了提高效能而使某些**變得難懂,應該使用注釋加以說明。 對於乙個比較長的程式段落,應該加注釋予以說明。如果設計文件中有流程圖,則程式中對應的位置應該加注釋予以說明。 如果程式中使用了某個複雜的演算法,建議註明其出處。 如果在除錯中發現某段落容易出現錯誤,應該註明。
1.常量、變數命名
用#define定義的符號常量全部採用大寫。
變數命名的基本原則:
可以選擇有意義的英文(小寫字母)組成變數名,使人看到該變數就能大致清楚其含義。
不要使用人名、地名和漢語拼音。
如果使用縮寫,應該使用那些約定俗成的,而不是自己編造的。
多個單詞組成的變數名,每個單詞的首字母應該大寫。如:dwuserinputvalue。
2.函式命名
函式命名原則與變數命名原則基本相同。對於初學者,函式命名可以採用「functionname」的形式。
每個程式通常分為兩個檔案:乙個檔案用於儲存程式的宣告,稱為標頭檔案;另乙個檔案用於儲存程式的實現,稱為定義檔案。
百度百科怎麼編寫?怎麼建立百度百科詞條?
最近很多在學校的同學都進入公司工作了,而大部分的工作都是跟專業對口做營銷推廣類。大家進入公司後第一時間就是希望公司能夠出現在百科上,成為乙個權威的認定。所以最近都很多朋友都在問我百科應該怎麼編寫,為什麼自己一直都編寫不通過。也有很多朋友把自己編寫好的詞條內容整理發給我,諮詢我為什麼不通過的原因,這樣...
程式編寫風格
1.編寫程式時,可以在運算子的左右或是逗號 之後適當地使用一些空白,讓程式看來不那麼擁擠。對比 int i 0 int i 0 2.在宣告字串並指定字串值時,如果字串長度過長,可以分作兩行來寫,比較容易閱讀,例如 string text n n 3.類名首字母大寫 方法名稱的命名慣例為首字母小寫 名...
百度小程式筆記
1 元件的使用注意點。1.1 元件在頁面內引入時不能放在有條件判斷的地方,否則在js裡的onready裡獲取元件時undefined。再呼叫元件裡面的方法時會報錯。1.2 元件內需要一進入頁面就呼叫介面且介面引數是頁面內js傳過來的時,頁面內的介面呼叫在onready裡面執行,然後在 裡面呼叫元件內...