Re: [請益] 程式該怎麼越寫越好呢

[yoco315 (眠月)]

※ 引述《adrianshum (Alien)》之銘言：
: 其實, 往往要寫一千字去解釋, 我覺得那不算真的高手.
: 我一向的目標都是要把程式寫得 self-descriptive, 要
: 別人不看 comment 也看得懂.
: comment 就留在偶然為了效率寫得難明, 或有特別東西要
: 別人留意的時候才用吧.
: (還在磨練中)

同意，還要寫註解那就代表程式碼本身描述力不足。
「程式可讀性」有個很經典的例子 XD
假設有一個 Date 類別，請問建構函數要怎麼設計？

        Date date1 = Jan(12, 2008) ;
        Date date2 = Feb( 9, 2009) ;

忘記在哪邊看到的了... XD

--
To iterate is human, to recurse, divine.
遞迴只應天上有, 凡人該當用迴圈.              　   L. Peter Deutsch

--
※ 發信站: 批踢踢實業坊(ptt.cc) 
◆ From: 203.160.254.105
→ adrianshum:這個... 是反面教材嗎?...
→ ykjiang:這個例子很正面，程式本身就很具描述性
→ tinlans:黑書前兩章的地方有提過。
→ chessjim:很不錯,只是要定義較複雜的語意就難摟
→ ykjiang:好的介面設計就是讓人一看用例就懂，
→ ykjiang:並且不容易忘記，因為是如此的自然 :)
→ ykjiang:這時如果再加註解，那就顯得多餘了
→ wa120:我反而不喜歡這樣設計這個Date Object
→ wa120:Date的原意在日期 這樣重點(Method)跑道
→ wa120:月份去了
→ ykjiang:不會跑到月份啦，看也知道是日期
→ ykjiang:用高階的方式思考，不要侷限在語言
→ ykjiang:program into a language;
→ ykjiang:NOT program in a language.
→ ykjiang:Jan(12, 2008) 不但易懂，還防呆
→ tinlans:跑到月份去的話那寫 Date date = 幹嘛。
推 kuninaka:何必呢
→ ykjiang:還有，月份只有 Jan ，不會有 (12, 2008)
→ adrianshum:你可以說我古板, 但 method 就該是動詞
→ adrianshum:當你看到一個叫 Jan 的 method, 那有什
→ adrianshum:麼好處呢?... 要防呆, 我寧願弄個enum
推 kuninaka:青菜蘿蔔各有喜好
推 adrianshum:我還是老論點: 這種違背正常設計原則的
→ adrianshum:創新方法, 待把程式撰寫作為工藝磨練好
→ adrianshum:才搞這種 "創新" 吧. 我實在不能苟同一
→ adrianshum:個叫 Jan 的 method, 超詭異的
→ adrianshum:Date d=getDate(2008, Month.JAN, 1);
→ adrianshum:這會比起那個寫法難讀嗎? 我覺得還比較
→ adrianshum:易讀, 防呆也沒分別
推 bobju:有些規範比較嚴格的軟體公司會限制程設師用
→ bobju:這類'別樹一格'的語法.
→ bobju:為什麼?搞得跟人家不一樣只會造成大家的困擾
→ bobju:.一看就懂嗎?只怕未必.因為人家還是希望有標
→ bobju:準文件做為參考基準.而不是讓程式自己說話.
→ ykjiang:to adrianshum, 你那樣寫的確也防呆，
→ ykjiang:看起來也很清楚，但用起來卻顯得比較累贅
→ ykjiang:若 Jan() 或 Date() 視為 constructor ，
→ ykjiang:或 factory method ，就不必堅持使用動詞
→ ykjiang:to bobju, 不確定你說的標準文件的內含，
→ ykjiang:為啥該文件會跟這個用例衝突，
→ ykjiang:就我知道，很少程式規範到那麼細的地方
→ ykjiang:另外，請區分 function 及 procedure
→ ykjiang:procedure 命名才會建議用動詞
→ ykjiang:我想 adrianshum 一定把這段碼當成 JAVA，
→ ykjiang:剛好想到 JAVA 的 new 也很累贅...
推 Schelfaniel:這就是Java程設師和C++程設師的不同
推 bobju:to ykjiang簡單講就是不要用自創的'程式語法
→ bobju:寫程式.你寫的程式碼用法最好都有官方文件為
→ bobju:參考根據.
→ adrianshum:和 C++/Java 沒關吧?! method 是動詞是
→ adrianshum:基本 OOAD 的做法吧...
推 zerodevil:樓上看rails的document一定會看到吐血..
推 zerodevil:寫起來像英文是好事啊 不一定要堅持什麼
→ zerodevil:OOAD的作法..
→ Schelfaniel:Java寫久了自然會比較接受Java那一套
→ adrianshum:其實我是幹了五六年 C++ development
→ adrianshum:最近幾年才主力寫 Java 而已. 我說的原
→ adrianshum:則在 C++ 的時候已經有遵從. 我常說,
→ adrianshum:創新不是問題, 但待你把基本的磨練好
→ adrianshum:才想創新的玩法吧.
→ ykjiang:內文明明就說是問「建構函式」怎麼設計
→ ykjiang:而不是問 object methods
→ ykjiang:例如數學函式也都命名為 sin(), cos() 等
→ ykjiang:不會是 getSin(), getCos()