编码风格 - 函数
每個函數都應該設計得盡可能簡單,簡單的函數才容易維護。應遵循以下原則:
-
實現一個函數只是為了做好一件事情,不要把函數設計成用途廣泛、面面俱到的,這樣的函數肯定會超長,而且往往不可重用,維護困難。
-
函數內部的縮進層次不宜過多,一般以少于4層為宜。如果縮進層次太多就說明設計得太復雜了,應考慮分割成更小的函數(Helper Function)來調用。
-
函數不要寫得太長,建議在24行的標準終端上不超過兩屏,太長會造成閱讀困難,如果一個函數超過兩屏就應該考慮分割函數了。[CodingStyle]中特別說明,如果一個函數在概念上是簡單的,只是長度很長,這倒沒關系。例如函數由一個大的
switch組成,其中有非常多的case,這是可以的,因為各case分支互不影響,整個函數的復雜度只等于其中一個case的復雜度,這種情況很常見,例如TCP協議的狀態機實現。 -
執行函數就是執行一個動作,函數名通常應包含動詞,例如
get_current、radix_tree_insert。 -
比較重要的函數定義上側必須加注釋,說明此函數的功能、參數、返回值、錯誤碼等。
-
另一種度量函數復雜度的辦法是看有多少個局部變量,5到10個局部變量已經很多了,再多就很難維護了,應該考慮分割成多個函數
?
The ending...
轉載于:https://www.cnblogs.com/xiangtao/archive/2013/04/11/3014722.html
總結
- 上一篇: 【IT笔试面试题整理】不用加减乘除做加法
- 下一篇: C++自动生成的成员函数