Chapter 4 - 註解
不要替糟糕的程式碼寫註解 - 重寫它
註解為必要之惡,用來彌補我們用程式碼表達意圖失敗的狀況。註解在絕大多數的情況無法跟著程式演進,導致過時且偏離當初的程式碼解釋。最後的真相只會存於程式碼。
有益的註解
法律型的註解
// Copyright 2011-2019 The Bootstrap Authors
// Copyright 2011-2019 Twitter, Inc.
資訊型註解
資訊型註解提供一些基本資訊,但還是很容易被好的程式碼命名給取代
...
2019年12月4日 星期三
2019年12月3日 星期二
讀書心得 - Clean Code - Chapter 3 (2)
Chapter 3 - 函式 - 2
使用具描述能力的名稱
不要害怕名字過長,若取了有性質的函式名稱就較能符合「當每個你看到的函式,執行結果都與你想的差不多代表為 Clean Code」。
函式的參數
函式的參數越少越好,因為參數的存在也會影響著你對函式的預期,所以最理想的情況為 0 參數。
一個參數
與這個參數有關的問題 - boolean fileExits("Myfile")
對這個參數做某種操作,然後回傳 - InputStream fileOpen("Myfile")
事件,利用參數去修改系統狀態...
2019年12月2日 星期一
讀書心得 - Clean Code - Chapter 3 (1)
Chapter 3 - 函式 - 1
首要準則 - 簡短!!
即使現今編輯器能讓你在一行塞入 150 個英文字母,現今螢幕能讓你顯示 100 行,你也不該塞好塞滿。越短越好,3 ~ 4 行,每個函式都透漏著本身的意圖且帶領著你至下個函式。
區塊 ( Blocks ) 和縮排 ( Indenting )
If、else、while 都應該只有 1 行,而那行通常會是個命名不錯的函式。
只做一件事
只做一件事很難下定義,以下提出兩種
透過觀察函式中進而提煉出一個新的函式來
函式裡有明顯的段落...
Popular Posts
-
lvalue 、rvalue 基本概念 左值 (lvalue) : 一個佔據某個特定記憶體的值。 右值 (rvalue) : 一個 expression 結束後就消失的值。 基本上這兩個定義包含了全部的值,非左即右,非右即左。 int var = 4; // v...
-
You try to hold me down so I became a soldier 你想要控制所以我成為了戰士 Built up all theses walls and now I'm climbing over 監牢般的城牆如今我已越過 Thos...
-
Ooh, don't we look good together? 我們看起來是不是很棒? There's a reason why they watch all night long 這就是為何他們整晚都看著我們的原因 Yeah, kn...
-
Job Company : Houzz Job : Back-End Software Engineer Source : Recruiter on LinkedIn Result : 止步二面 Summary 1. 英文程度不佳 :...
-
Don't lie, I know you've been thinking it 別說謊了,我知道你一直很渴望 And two times, you let it slip from your lips 兩次了,你那不想讓人聽見的低語 You...
-
報告在製作時,一定會遇到要字串轉數字 在 BCB 裡有方便的函式 常見的有 String str = "123" int x = StrToInt(str); float y = StrToFloat(str); 但有時候...
-
BCB 選擇路徑(資料夾) 工作關係要將各式各樣的資料彙整並輸出 各式各樣的資料都放在同一目錄下 所以在設計程式就必須設計可以給使用者選擇目錄 但BCB10似乎沒有這種元件 (其實有 DirectoryListBox 但我駕馭不了) 於是Google發現大家用的...
-
BCB TDateTime 時間操作及應用 在 BCB 裡有關時間的操作幾乎都是與 TDateTime 這個 Class 相關 若找不到相關資料可以用 BCB 的 HELP ( 游標移到要查詢的函式或Class 並按 F1 ) 介紹幾個個人有在用的函式 TDate...
-
Python Google API - Python 學習筆記 Google API - Python 學習筆記 - Upload post
-
warning: left shift count >= width of type 一般來說,就是 shift 的 bit 大於資料型態的 bit 數。但有時使用 unsigned long 仍然會出錯,因為 unsigned long 會依照系統的不同,有...