使用namespace的正確方法

使用namespace的正確方法

原作：Dejan Jelovic 翻譯：zhigang

[譯者注]受本人翻譯水平限制，可能原文作者的本意並沒有被完全準確的表達出來，如果你在閱讀本文的過程中出現問題，你可以給我寫信coolgrass@sina.com

來自:www.codeproject.com

標題: Using Namespaces Properly


命名空間（namespace）在C++中的作用非同一般。本文目的不在於闡述命名空間的文法，而在於示範命名空間的使用方法，或者說是使用命名空間的小竅門。

命名空間可以簡單的將一些命名（name）用另一個命名打包封裝起來。比方說：

namespace net { class Socket { ... }; } ... net::Socket socket;

經過這樣的封裝以後，如果在兩個庫（library）都實現了Socket類，只要它們命名空間的名字不同，你就可以同時使用它們而沒有任何命名上的衝突。


但這樣做還是有問題：假如兩個公司都要寫一個network庫，那麼當她們編寫代碼的時候都使用Socket命名他們的類的可能性有多大？我猜是接近100％。

命名空間的名字最好是方便輸入的，就是說命名空間的名字最好別太長了，2－4個字元就可以了。抱著這樣的想法，那兩個公司把他們的命名空間叫做net的機會又是多大呢？5%還是10％？

不難看出，命名空間並沒有解決所有問題，它只是使發生命名衝突的機會相對小了而已。

有一種叫做“工業化長度”的方法（Industrial Strength Solution），這種方法在命名namespace的時候使用長的唯一的名稱，而在程式裡使用短的別名。如此network庫就可能會是這個樣子：

namespace net_33843894 { class Socket { ... }; }

net_後面的數字是由一個隨機數產生器產生的。為了以後描述方便，這裡我們假定上面的代碼是放在<netlib>標頭檔裡。

使用者使用我們的庫的時候，就要編寫他自己的標頭檔<mynetlib>，包含下面的內容：

#include <netlib> namespace net = net_33843894;

他建立了一個在本工程內有效別名，用來代表提供給他的庫中的命名空間。如果名稱net已經被別的庫使用了，那麼他還可以另選一個名字代替，例如：net2,sock，或者別的什麼。

這樣就萬事大吉了嗎？還沒有。你還要做一件事：使你的庫用起來更簡單、更方便。在這個講究完美的社會裡，人們雙擊一個安裝檔案後，你的庫在他們的開發環境裡就應該是可用的，接下來就是#include <netlib>，再接下來他們就可以去忙別的了。

然而，現在的情況是，使用者為了使用你的庫需要建立一個他自己的標頭檔，雖然這並沒有什麼大不了的，但不是每個使用者都能忍受這一點。解決的方法就是直接提供一個合理的預設值，如果使用者覺得不合適也可以取消，所以，在你的標頭檔裡使用先行編譯選項，如下：

namespace net_33843894 { class Socket { ... }; } #ifndef NO_NET_33843894_ALIAS namespace net = net_33843894; #endif

這樣我們就給命名空間的名字提供了一個預設值，如果這個名字已經有人用了，那麼使用者可以定義一個NO_NET_33843894_ALIAS宏，別名就會被取消。

不幸的是，即使是使用了短的別名net，當你使用Socket類的方法不對的時候，在我所用過的編譯器中，沒有一個能夠在錯誤提示資訊裡顯示的短的別名，而是仍然使用net_33843894::Socket。讀起來有些費勁。

怎麼辦？看我的。

#ifdef NO_NET_33843894_ALIAS namespace net_33843894 { #else namespace net { #endif class Socket { ... }; } #ifndef NO_NET_33843894_ALIAS namespace net_33843894 = net; #endif

如果沒有定義宏NO_NET_33843894_ALIAS, 就直接給命名空間起個短一點的名字，把別名弄長點就可以了。這樣，錯誤資訊讀起來就會順眼多了。