如果引用或轉貼,麻煩註明出處與本網誌連結,否則視為侵權。

2005年1月6日

如何寫出無法維護的程式 - 命名 11-15

原作 : How To Write Unmaintainable Code, Roedy Green©1997-2004 Canadian Mind Products
中譯 : Fred F.M. Wang 2005/1/3
11. Exploit Compiler Name Length Limits 利用compiler在名稱長度的限制
如果編譯器只判別名稱的前八字元,那麼就變更結尾字元,例如一個用var_unit_update(),另一個用var_unit_setup()。編譯器將兩個都視為var_unit。
: If the compiler will only distinguish the first, say, 8 characters of names, then vary the endings e.g. var_unit_update() in one case and var_unit_setup() in another. The compiler will treat both as var_unit.

12. Underscore, a Friend Indeed用底線
: Use _ and __ as identifiers.

13. Mix Languages 混合語言
混用兩種語言(人與電腦)。如果你的老闆堅持你使用他的語言,就告訴他,你只能用你自己的語言組織你的思想,如果這種方式沒有用則控告他語言歧視。
: Randomly intersperse two languages (human or computer). If your boss insists you use his language, tell him you can organize your thoughts better in your own language, or, if that does not work, allege linguistic discrimination and threaten to sue your employers for a vast sum.

14. Extended ASCII 用ASCII擴充碼
ASCII的擴充碼拿來作變數名稱,包含ß, Ð, and ñ等字元。這些字在一般簡單的文字編輯器沒有複製貼上的話是幾乎無法輸入的。
: Extended ASCII characters are perfectly valid as variable names, including ß, Ð, and ñ characters. They are almost impossible to type without copying/pasting in a simple text editor.

15. Names From Other Languages 用別種語言命名
用外國語言字典當作變數名稱的來源。例如用德語的punkt表示point。維護程式的人如果沒有你對德語的了解,則將會享受到翻譯多國語言的經驗。
: Use foreign language dictionaries as a source for variable names. For example, use the German punkt for point. Maintenance coders, without your firm grasp of German, will enjoy the multicultural experience of deciphering the meaning.

譯者註 :
11-15條實際要說明的是
a.如果編譯器只能判別名稱的前八字元,則命名上就要注意不要有前八碼相同的名稱。
b.不要用底線作為變數名稱的字元。
c.不要混用兩種語言如機器語言及自然語言。
d.不要使用ASCII的擴充碼。
e.不要用別國的語言,最好使用標準的英文。
2005/01/06 Fred Wang(http://fredwang.blogspot.com%20/)

相關文章

如何寫出無法維護的程式- 簡介
如何寫出無法維護的程式- 基本原則
如何寫出無法維護的程式- 命名1-5
如何寫出無法維護的程式- 命名6-10
如何寫出無法維護的程式- 命名11-15

沒有留言:

張貼留言

歡迎提供意見, 謝謝 (註 : 留言經過版主審核通過才會發布)