Re: [心得] 學好程式設計的訣竅
這樣子吧..
enum rs232Flag{rs232Open=0, rs232Close=1};
...
rs232Flag RS232com1 = rs232Close;
...
if(rs232Open == RS232com1){//常數放左邊是一個好習慣
//...does something
}
這個例子比較簡單，所以看不出加註解的必要。
通常寫程式我個人建議一定要放註解，尤其是每個函式的前面，要描述這個
函式的功能，使用了哪些資料結構與演算法，輸入參數的用途，越詳細越好，
如同寫報告一般。如此就算是上萬行的程式碼，也可以讓第三者輕鬆掌握程
式架構。
※ 引述《goodrain (大橘永澤邱哥)》之銘言：
: 關於大家對註解的歧見，我想跟大家分享一下書中對於註解的建議
: 他是這麼說的:
: 比如說我們常寫到以下程式
: int com = 0 ; //RS232的旗標 0 是關閉 1 是開啟
: if(com = = 1) //RS232通訊開啟
: {
: }
: 如果換寫成這樣呢?
: int RS232com1_flag = 0 ,close = 1 ,Open = 0;
: if(RS232com1_flag = = Open)
: {
: }
: 咦?發生了什麼事....
: 所有註解都不見了吧
: 變數一看就知道是什麼了
: 這種方法好處特別是在程式越來越大的情況之下，旗標設定很容易遠遠的遠離使用的地方
: 且旗標狀態往往可能用到四~五個狀態以上，如果不這樣寫....
: 就會寫出連自己都會看錯的程式，更何況是同事或客戶要來理解了...
: 我自己的親身經歷是
: 我一開始用第一種方法 程式寫了七百行左右就開始吐血了 (功力低弱...)
: 寫到後來想修改或添加新功能，不管如何修改都會有BUG
: 現在發憤整個重寫程式，且順便新增了一堆功能上去
: 目前程式來到了1500行，我還覺得這不是我的極限 XDDD
: 不過最一開始那位提說不看註解的大大
: 其實我覺得他也是對的/....\
: 這是學習的其中一個過程
: 因為總不能要求小朋友做的紙飛機時
: 要求他在上面要可以掛巡弋飛彈吧?
: 大家一起加油吧~
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 165.91.193.130
推
10/19 09:35, , 1F
10/19 09:35, 1F
推
10/19 09:41, , 2F
10/19 09:41, 2F
→
10/19 09:57, , 3F
10/19 09:57, 3F
推
10/19 09:58, , 4F
10/19 09:58, 4F
→
10/19 09:58, , 5F
10/19 09:58, 5F
→
10/19 09:58, , 6F
10/19 09:58, 6F
→
10/19 21:28, , 7F
10/19 21:28, 7F
→
10/19 23:41, , 8F
10/19 23:41, 8F
→
10/19 23:41, , 9F
10/19 23:41, 9F
→
10/19 23:41, , 10F
10/19 23:41, 10F
推
10/20 11:30, , 11F
10/20 11:30, 11F
推
10/20 12:27, , 12F
10/20 12:27, 12F
→
10/20 12:27, , 13F
10/20 12:27, 13F
推
10/21 15:45, , 14F
10/21 15:45, 14F
推
10/21 19:10, , 15F
10/21 19:10, 15F
→
10/21 19:11, , 16F
10/21 19:11, 16F
推
10/21 19:51, , 17F
10/21 19:51, 17F
推
10/22 15:55, , 18F
10/22 15:55, 18F
→
10/22 17:28, , 19F
10/22 17:28, 19F
討論串 (同標題文章)