Posted on January 22nd, 2006 at 3:46 by fr3@K
在 open source 的世界也好, 在公司內部也好, 任何像樣的 project, 大都免不了採用或自訂一套 coding convention. 不同 coding convention 所要達成的目標並不盡相同, 但都有個共同點 – 讓你寫的 code 看起來像是別人寫的. 主要原因是 – 這樣做應該可以讓他人容易閱讀/理解/修改你寫的 code.
Coding convention 主要分為兩個部份:
- Naming notation (命名法)
- Formatting (程式格式/排版)
以我個人經驗以及從朋友處得到的消息來看, 公司內部最常採用的 naming notation 是 Hungarian Notation (匈牙利命名法). 把 Hungarian notation 傳播到世界各地, 甚至錯誤地使用在例如 C++ 之類的 strong-typed (或是接近 strong-typed) 語言上, M$ 功不可沒, Win32 SDK 與 MFC 是其中經典之作. 時至今日, 就連 M$ 內部也已展開了反撲, 最好的例子就是 .NET 丟開 M$ 過去採用 hungarian notation 的包袱.
我痛恨 hungarian notation, 但這通常不會造成我在工作上的困擾. 我總是能幸運地說服同事與上司放棄它, 或至少不強迫我採用它. 不過還是常會有朋友跟我抱怨公司強迫他們採用 hungarian notation, 他們多是無奈接受. 這帖 blog, 就是為了這些朋友寫的, 如果你剛好在這些公司工作, 不妨把這帖 blog 的 link 轉給你的同事或上司.
Annoyances of the Hungarian Notation:
- 視你為弱智. 認為你替變數取的名字大都不好, 很難從名字辨認大約的型別
- 視你為白痴. 認為你有可能會 – 把一個叫做 size 的變數 (不是 integral type 還能是什麼?) 誤判為一個 ifstream 的 instance
- 視 strong-typed compiler (如 C++ 編譯器) 為低能. 認為 compiler 有可能會 – 在你把一個叫 name 的變數 (不是某種字串還能是什麼?) 當作 ComboBox 來操作時, 不產生 compile error
我常用的命名法則是盡量口語化, 並試著恰如其分地命名. 舉例說明較快:
- Instance of integral type
unsigned long user_count; int offset; size_t index, received_bytes;
class Contact; class FastString; typedef list<Contact> Contacts; // or ContactList
string english_name; Contacts kens_contacts; // or contacts_of_ken Window main_window;
誤判以上所舉例子型別的人, 或許該考慮換個工作 
.
當然, 上例都是淺顯的例子, 從我個人經驗來說, 應用這原則倒也沒遇過特別困難的狀況. 我想說的並不是我用的方法多好, 而是希望別再有更多人強迫他人或被他人強迫用什麼彆腳的 dwData, wndMain, ctrlBrowser, nCount, szName 來寫 C++.
[Update] Sutter on Hungarian Notation.
        |
|
| Previous Post « C++ Terminology – 0. 前序 « |
Next Post » C++ Terminology – 1. Variety of Types » |
size 可以是float, double, DWORD, WORD, size_t
某些時候我希望是 D3DVECTOR3 ….(3度空間下)
所以我不認為Hungarian Notation就是很笨的方法.
雖然我也不是完全遵守…
Comment by 也用C++的程式設計師 — July 12, 2006 @ 15:36