可憐的Bool——淺析程序可擴展性

2019-11-17 05:36:09

字體：大中小

來源：轉載

供稿：網友

　　嘿嘿...今天的活比較爽！前幾天寫了點破程序，今天改改就搞定了。

　　哎，真困！喝點咖啡，靠在我的小椅子上，看看我的代碼...

　　神奇，這是啥？

void f()
{
TextHandler t;
t.sendText("Hello, world", true);
// ...
}
　　后面那個true是什么東東？翻翻定義:

class TextHandler
{
public:
void sendText( const std::string & msg,
bool sendNewLine );
//...
};
　　喝點coffee，我想起來了，true表示sendText函數自動加上一個回車換行，我怎么忘了？

　　難道是我笨？我陷入迷茫的沉思...

　　砰！！！的一聲巨響，我一慌張，嘴里的咖啡差點噴出來，還好我嘴緊。一定是Guru合上了她的什么大頭書。我轉向她，擠出一點微笑。她手里拿著一本不到一百頁的小冊子。神奇，這么小的書弄得這么響，她是怎么弄得？

　　顯然，她什么都知道了。

　　"我的寶貝！假如你這么快就忘了參數的含義，那么當其他程序員第一次看你的代碼的時候，他怎么明白你要表達的意思呢？"

　　"嗯，是啊" 我咕嚕道 "但是在IDE里面，他只要把鼠標移到函數上，他就可以看到參數說明了啊！"

　　"有些IDE如此，并非全部，甚至不是大多數！我說過很多次，源代碼最主要的用途是用來交流，對意圖的交流。我手中這本古老的，令人尊敬的卷冊闡述了交流的藝術。在這兒，它寫道，'使用明確，具體，具體的語言'[1]，你代碼中的bool與此無緣，他不能傳遞任何有用的信息給讀者。 "

　　"不哈，一旦他知道這個bool是什么意思，就很輕易記住了哈！"我中氣不足的說。

　　Guru用她漂亮而堅定的藍眼睛盯著我，我心里撲通撲通跳起來。

　　"你多久以前寫的這段代碼？"Guru很溫柔的說道--那種我喜歡的溫柔。

　　"嗯，好，嗯，那如何改正呢？"我巧妙的回避她的問題。

　　"你不能另外想一種方式去表達你的意圖嗎？"她也不直接回答我，我們就似乎在煎雞蛋。

　　"我可以不要第二個參數，讓用戶自己加 '/n' 好了。"我邊說邊寫:

{
t.sendText("Hello, world/n");
}
　　"假如傳遞給sendText是一個變量呢？" Guru問。

　　"那就這樣好了"

{
t.sendText( variable );
t.sendText( "/n" );
}
　　我抬頭看到Guru臉色不善，趕緊說道:

　　"那就這樣，我提供兩個函數"

void sendText( const std::string & );
void sendTextWithNewLine( const std::string & );
　　"沒有其他的辦法了嗎？"Guru思考的時候，微微皺眉。

　　哎，看來我今天不要想輕松溜走了，我一陣猛想......什么也沒想出來，我投降了，"就這樣吧！"

　　"關于你的問題，你還要熟悉一點" Guru寫道:

void displayText( const std::string &,bool applyItalics, bool applyBold );

void f(){
displayText( "This is bold but not italic",true, false );
}
　　"假如一個程序員要用斜體顯示文字，但是弄錯了參數順序，那么這些文字就要用粗體顯示了，而且
顯然編譯器無法發現這個錯誤。"

　　"假如Bob拿到了這段代碼，改變了參數的順序，一種叫做'Permute And Baffle'的技術[2]。會怎樣？"

　　"顯然，問題多多的displayText不能得到 '明確，具體，具體' 的參數。"

　　"現在來看你的問題，你的第一個方案，因為displayText需要其他參數而沒法用。你的第二個方案，
可以工作，但是假如displayText需要很多信息，比如顏色，
　　"所以，我們可以用enumerated."

　　"Enumerations?"我希奇的說。

　　"是的，Enumerations在這兒能得到很好的應用，看，"

class TextHandler
{
　public:
　　enum NewLineDisposition { sendNewLine, noNewLine };
　　void sendText( const std::string &, NewLineDisposition );
};

void f()
{
　TextHandler t;
　t.sendText( "Hello, ", TextHandler::noNewLine );
　t.sendText( "world", TextHandler::sendNewLine );
}
　　"這種寫法很好，這段代碼現在self-documenting了，不需要注釋，意圖和結果都很清楚。看的人不需要去查找函數的定義了。"

　　"而且，這種寫法有很好的擴展性，假如你需要只加一個回車，你只需要在enumeration中加上
　　"不要拋棄你第一個方案，寶貝。在有的情況下，他是最優的。"Guru轉過身，重新打開那本書，優雅而輕快的走開，消失在拐角處。

　　注解:

　　[1] William Strunk Jr. and E.B. White. The Elements of Style (MacMillan Publishing Co. Ltd,

1979).

　　[2] From Roedy Green's "How To Write Unmaintainable Code,"

<http://mindprod.com/unmaindesign.Html>. (Primarily aimed at java programmers, it still has
lots of relevance for C++ programmers.)

上一篇：exit()子程序終止函數與return()函數的差別

下一篇：簡單潛艇大戰