函數(shù)

短小

函數(shù)的第一規(guī)則是要短小;第二條規(guī)則則是還要更短小
函數(shù)應(yīng)該20行封頂。

  • 代碼塊和縮進
    if語句、else語句、while語句等,其中的代碼塊應(yīng)該只有一行,該行大致是一個函數(shù)調(diào)用語句。這樣不僅能保持函數(shù)短小,而且因為塊內(nèi)調(diào)用的函數(shù)擁有較具說明性的名稱,從而增加了文檔的價值。
  • 只做一件事
    函數(shù)應(yīng)該做一件事。做好這件事。只做這一件事。
    判斷函數(shù)是否做了不止一件事的一個方法就是能否再拆出一個函數(shù),這個函數(shù)不是單純的重新詮釋其實現(xiàn)。
    只做一件事的函數(shù)無法被合理地切分為多個區(qū)段。
  • 每個函數(shù)一個抽象層級
    要確保函數(shù)只做一件事,函數(shù)中的語句都在同一抽象層級上。

自頂向下讀代碼:向下規(guī)則
我們想讓代碼擁有自頂向下的閱讀順序。我們想讓每個函數(shù)后面都跟著位于下一抽象層級的函數(shù),這樣一來,在查看函數(shù)列表是,就能循抽象層級向下閱讀。我們把這叫做向下規(guī)則。
換一種說法我們想要這樣讀程序:程序就像是一系列TO起頭的段落,每一段都描述當(dāng)前抽象層級,并引用位于下一抽象層級的后續(xù)TO起頭段落。

  • switch語句
    對于switch語句,如果只出現(xiàn)一次,用于創(chuàng)建多態(tài)對象,并且隱藏在某個繼承關(guān)系中,在系統(tǒng)其他部分看不見,就還能容忍。

使用描述性的名稱

選擇描述性的名稱能理清關(guān)于模塊的設(shè)計思路,有助于改進。
命名方式要保持一致。使用與模塊名一脈相承的短語、名詞和動詞給函數(shù)命名。

函數(shù)參數(shù)

零參數(shù)函數(shù) 優(yōu)于 單參數(shù)函數(shù) 優(yōu)于 雙參數(shù)函數(shù);因盡量避免三參數(shù)以上的函數(shù)。
輸出參數(shù)比輸入?yún)?shù)要難以理解。我們慣于認為信息通過參數(shù)傳入函數(shù),通過返回值從函數(shù)輸出。我們不太期望信息通過參數(shù)輸出。

  • 一元函數(shù)
    向函數(shù)傳入單個參數(shù)有兩種極普遍的理由。

    1. 問關(guān)于那個參數(shù)的問題
    2. 操作參數(shù)

    還有一種不那么普遍但仍極有用的單參數(shù)函數(shù)形式,那就是事件。在這種形式中,有輸入?yún)?shù)無輸出參數(shù)。
    所以我們在命名時要注意名稱的區(qū)別,讓讀者能輕易分辨是哪種類型。

  • 參數(shù)對象
    如果函數(shù)看起來需要二個、三個和三個以上參數(shù),就說明其中一些參數(shù)應(yīng)該封裝成類。

  • 動詞與關(guān)鍵詞
    給函數(shù)起個好名字,能更好的解釋函數(shù)的意圖,以及參數(shù)的順序和意圖。對于一元函數(shù),函數(shù)和參數(shù)應(yīng)當(dāng)形成一種非常良好的動詞/名詞對形式

其他

  • 分隔指令與詢問
    函數(shù)要么做什么事,要么回答什么事,但二者不可兼得。函數(shù)應(yīng)該修改某對象的狀態(tài),或者返回對象的有關(guān)信息。
  • 使用異常代替返回錯誤碼
  • 抽離try/Catch代碼塊
  • 錯誤處理就是一件事
  • 別重復(fù)自己
  • 結(jié)構(gòu)化編程
    每個函數(shù)、函數(shù)中的每個代碼塊都應(yīng)該有一個入口、一個出口。這意味著每個函數(shù)中只該有一個return,不能有break或continue語句,而且永永遠遠不能用有g(shù)oto語句。
    但是只要函數(shù)保持短小,偶爾出現(xiàn)的return、break或continue語句沒有壞處。但是goto在小函數(shù)中應(yīng)該盡量避免使用。
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,702評論 6 531
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,143評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,553評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,620評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 71,416評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 54,940評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,024評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,170評論 0 287
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 48,709評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 40,597評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,784評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,291評論 5 357
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,029評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,407評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,663評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,403評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 47,746評論 2 370

推薦閱讀更多精彩內(nèi)容