摘要:[獨自murmur]function命名時,正確地使用對立名稱
reference: Code Complete2, Ch7-3, Good Routine Names: Use opposites precisely
function的命名,一向是很多程式裡面造成可讀性低的一大問題,
好的程式應該具備「自我文件化」的特性,也就是人家可以直接從您的code,瞭解您要表達的意思。
尤其是function通常是代表一個抽象化的概念,命名就變得格外重要。
好的function name通常都會包括了動作與目標物件,
所以,瞭解一些特定的term,便是一個好的coding rule應該限定的範圍,
當大家都遵守這樣的規範的時候,才能用同樣的語言進行溝通。
下面這張表是書中提及,對立的「動作」名稱,為了維持它的美感,我就不特地翻成中文了,對term有問題的人,
大家再來討論看看適用於什麼樣的情形。
這張表並非絕對正確,但是可以提供給我們當作一個指標性的參考。
- add/remove
 - increment/decrement
 - open/close
 - begin/end
 - insert/delete
 - show/hide
 - create/destroy
 - lock/unlock
 - source/target
 - first/last
 - min/max
 - start/stop
 - get/put
 - next/previous
 - up/down
 - get/set
 - old/new
 
blog 與課程更新內容,請前往新站位置:http://tdd.best/
